@forklaunch/implementation-billing-stripe 1.0.1 → 1.1.1

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

@@ -37,7 +37,7 @@ export class StripeWebhookService<
   SubscriptionEntities extends
     StripeSubscriptionEntities<PartyEnum> = StripeSubscriptionEntities<PartyEnum>
 > {
-  protected readonly defaultPartyType: PartyEnum[keyof PartyEnum];
+  protected readonly partyEnum: PartyEnum;
   protected readonly stripeClient: Stripe;
   protected readonly em: EntityManager;
   protected readonly schemaValidator: SchemaValidator;
@@ -91,9 +91,9 @@ export class StripeWebhookService<
       PartyEnum,
       SubscriptionEntities
     >,
-    defaultPartyType: PartyEnum[keyof PartyEnum]
+    partyEnum: PartyEnum
   ) {
-    this.defaultPartyType = defaultPartyType;
+    this.partyEnum = partyEnum;
     this.stripeClient = stripeClient;
     this.em = em;
     this.schemaValidator = schemaValidator;
@@ -105,6 +105,21 @@ export class StripeWebhookService<
     this.subscriptionService = subscriptionService;
   }
 
+  /**
+   * Resolve the party type for a subscription event.
+   * Stripe subscriptions are customer-scoped — customers map to users
+   * by default. Override this method to implement organization-level
+   * subscriptions or other party resolution logic.
+   */
+  protected resolvePartyType(_event: Stripe.Event): PartyEnum[keyof PartyEnum] {
+    // Default: first value in the enum container.
+    // Subclasses can override to inspect event metadata for party type.
+    const keys = Object.keys(this.partyEnum as Record<string, unknown>);
+    return (this.partyEnum as Record<string, PartyEnum[keyof PartyEnum]>)[
+      keys[0]
+    ];
+  }
+
   /**
    * Extract features from Stripe product metadata.
    * Features can be stored as:
@@ -379,7 +394,7 @@ export class StripeWebhookService<
               typeof event.data.object.customer === 'string'
                 ? event.data.object.customer
                 : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? undefined,
             active: true,
             productId: event.data.object.items.data[0].plan.id,
@@ -412,7 +427,7 @@ export class StripeWebhookService<
               typeof event.data.object.customer === 'string'
                 ? event.data.object.customer
                 : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? undefined,
             active: true,
             externalId: event.data.object.id,

package/lib/services/index.d.mts

@@ -159,7 +159,7 @@ declare class StripeSubscriptionService<SchemaValidator extends AnySchemaValidat
 }
 
 declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, StatusEnum, PartyEnum, BillingPortalEntities extends StripeBillingPortalEntities = StripeBillingPortalEntities, CheckoutSessionEntities extends StripeCheckoutSessionEntities<StatusEnum> = StripeCheckoutSessionEntities<StatusEnum>, PaymentLinkEntities extends StripePaymentLinkEntities<StatusEnum> = StripePaymentLinkEntities<StatusEnum>, PlanEntities extends StripePlanEntities = StripePlanEntities, SubscriptionEntities extends StripeSubscriptionEntities<PartyEnum> = StripeSubscriptionEntities<PartyEnum>> {
-    protected readonly defaultPartyType: PartyEnum[keyof PartyEnum];
+    protected readonly partyEnum: PartyEnum;
     protected readonly stripeClient: Stripe__default;
     protected readonly em: EntityManager;
     protected readonly schemaValidator: SchemaValidator;
@@ -169,7 +169,14 @@ declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, S
     protected readonly paymentLinkService: StripePaymentLinkService<SchemaValidator, StatusEnum, PaymentLinkEntities>;
     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>, defaultPartyType: PartyEnum[keyof PartyEnum]);
+    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>, partyEnum: PartyEnum);
+    /**
+     * Resolve the party type for a subscription event.
+     * Stripe subscriptions are customer-scoped — customers map to users
+     * by default. Override this method to implement organization-level
+     * subscriptions or other party resolution logic.
+     */
+    protected resolvePartyType(_event: Stripe__default.Event): PartyEnum[keyof PartyEnum];
     /**
      * Extract features from Stripe product metadata.
      * Features can be stored as:

package/lib/services/index.d.ts

@@ -159,7 +159,7 @@ declare class StripeSubscriptionService<SchemaValidator extends AnySchemaValidat
 }
 
 declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, StatusEnum, PartyEnum, BillingPortalEntities extends StripeBillingPortalEntities = StripeBillingPortalEntities, CheckoutSessionEntities extends StripeCheckoutSessionEntities<StatusEnum> = StripeCheckoutSessionEntities<StatusEnum>, PaymentLinkEntities extends StripePaymentLinkEntities<StatusEnum> = StripePaymentLinkEntities<StatusEnum>, PlanEntities extends StripePlanEntities = StripePlanEntities, SubscriptionEntities extends StripeSubscriptionEntities<PartyEnum> = StripeSubscriptionEntities<PartyEnum>> {
-    protected readonly defaultPartyType: PartyEnum[keyof PartyEnum];
+    protected readonly partyEnum: PartyEnum;
     protected readonly stripeClient: Stripe__default;
     protected readonly em: EntityManager;
     protected readonly schemaValidator: SchemaValidator;
@@ -169,7 +169,14 @@ declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, S
     protected readonly paymentLinkService: StripePaymentLinkService<SchemaValidator, StatusEnum, PaymentLinkEntities>;
     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>, defaultPartyType: PartyEnum[keyof PartyEnum]);
+    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>, partyEnum: PartyEnum);
+    /**
+     * Resolve the party type for a subscription event.
+     * Stripe subscriptions are customer-scoped — customers map to users
+     * by default. Override this method to implement organization-level
+     * subscriptions or other party resolution logic.
+     */
+    protected resolvePartyType(_event: Stripe__default.Event): PartyEnum[keyof PartyEnum];
     /**
      * Extract features from Stripe product metadata.
      * Features can be stored as:

package/lib/services/index.js

@@ -622,7 +622,7 @@ var BillingPortal = (0, import_persistence.defineComplianceEntity)({
   properties: {
     id: import_persistence.fp.string().primary().compliance("none"),
     customerId: import_persistence.fp.string().compliance("none"),
-    providerFields: import_persistence.fp.json().compliance("none")
+    providerFields: import_persistence.fp.json().compliance("pci")
   }
 });
 var CheckoutSession = (0, import_persistence.defineComplianceEntity)({
@@ -633,7 +633,7 @@ var CheckoutSession = (0, import_persistence.defineComplianceEntity)({
     paymentMethods: import_persistence.fp.enum().array().compliance("none"),
     currency: import_persistence.fp.enum().compliance("none"),
     status: import_persistence.fp.enum().compliance("none"),
-    providerFields: import_persistence.fp.json().compliance("none")
+    providerFields: import_persistence.fp.json().compliance("pci")
   }
 });
 var PaymentLink = (0, import_persistence.defineComplianceEntity)({
@@ -644,7 +644,7 @@ var PaymentLink = (0, import_persistence.defineComplianceEntity)({
     paymentMethods: import_persistence.fp.enum().array().compliance("none"),
     currency: import_persistence.fp.enum().compliance("none"),
     status: import_persistence.fp.enum().compliance("none"),
-    providerFields: import_persistence.fp.json().compliance("none")
+    providerFields: import_persistence.fp.json().compliance("pci")
   }
 });
 var Plan = (0, import_persistence.defineComplianceEntity)({
@@ -657,7 +657,7 @@ var Plan = (0, import_persistence.defineComplianceEntity)({
     cadence: import_persistence.fp.enum().compliance("none"),
     currency: import_persistence.fp.enum().compliance("none"),
     billingProvider: import_persistence.fp.enum().compliance("none"),
-    providerFields: import_persistence.fp.json().compliance("none")
+    providerFields: import_persistence.fp.json().compliance("pci")
   }
 });
 var Subscription = (0, import_persistence.defineComplianceEntity)({
@@ -669,7 +669,7 @@ var Subscription = (0, import_persistence.defineComplianceEntity)({
     partyType: import_persistence.fp.enum().compliance("none"),
     billingProvider: import_persistence.fp.enum().compliance("none"),
     active: import_persistence.fp.boolean().compliance("none"),
-    providerFields: import_persistence.fp.json().compliance("none")
+    providerFields: import_persistence.fp.json().compliance("pci")
   }
 });
 var StripeWebhookEvent = (0, import_persistence.defineComplianceEntity)({
@@ -681,7 +681,7 @@ var StripeWebhookEvent = (0, import_persistence.defineComplianceEntity)({
     stripeId: import_persistence.fp.string().compliance("none"),
     idempotencyKey: import_persistence.fp.string().nullable().compliance("none"),
     eventType: import_persistence.fp.string().compliance("none"),
-    eventData: import_persistence.fp.json().compliance("none")
+    eventData: import_persistence.fp.json().compliance("pci")
   }
 });
 
@@ -692,7 +692,7 @@ var BillingProviderEnum = {
 
 // services/webhook.service.ts
 var StripeWebhookService = class {
-  defaultPartyType;
+  partyEnum;
   stripeClient;
   em;
   schemaValidator;
@@ -702,8 +702,8 @@ var StripeWebhookService = class {
   paymentLinkService;
   planService;
   subscriptionService;
-  constructor(stripeClient, em, schemaValidator, openTelemetryCollector, billingPortalService, checkoutSessionService, paymentLinkService, planService, subscriptionService, defaultPartyType) {
-    this.defaultPartyType = defaultPartyType;
+  constructor(stripeClient, em, schemaValidator, openTelemetryCollector, billingPortalService, checkoutSessionService, paymentLinkService, planService, subscriptionService, partyEnum) {
+    this.partyEnum = partyEnum;
     this.stripeClient = stripeClient;
     this.em = em;
     this.schemaValidator = schemaValidator;
@@ -714,6 +714,16 @@ var StripeWebhookService = class {
     this.planService = planService;
     this.subscriptionService = subscriptionService;
   }
+  /**
+   * Resolve the party type for a subscription event.
+   * Stripe subscriptions are customer-scoped — customers map to users
+   * by default. Override this method to implement organization-level
+   * subscriptions or other party resolution logic.
+   */
+  resolvePartyType(_event) {
+    const keys = Object.keys(this.partyEnum);
+    return this.partyEnum[keys[0]];
+  }
   /**
    * Extract features from Stripe product metadata.
    * Features can be stored as:
@@ -922,7 +932,7 @@ var StripeWebhookService = class {
           {
             id: event.data.object.id,
             partyId: typeof event.data.object.customer === "string" ? event.data.object.customer : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? void 0,
             active: true,
             productId: event.data.object.items.data[0].plan.id,
@@ -945,7 +955,7 @@ var StripeWebhookService = class {
           {
             id: event.data.object.id,
             partyId: typeof event.data.object.customer === "string" ? event.data.object.customer : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? void 0,
             active: true,
             externalId: event.data.object.id,

package/lib/services/index.mjs

@@ -590,7 +590,7 @@ var BillingPortal = defineComplianceEntity({
   properties: {
     id: fp.string().primary().compliance("none"),
     customerId: fp.string().compliance("none"),
-    providerFields: fp.json().compliance("none")
+    providerFields: fp.json().compliance("pci")
   }
 });
 var CheckoutSession = defineComplianceEntity({
@@ -601,7 +601,7 @@ var CheckoutSession = defineComplianceEntity({
     paymentMethods: fp.enum().array().compliance("none"),
     currency: fp.enum().compliance("none"),
     status: fp.enum().compliance("none"),
-    providerFields: fp.json().compliance("none")
+    providerFields: fp.json().compliance("pci")
   }
 });
 var PaymentLink = defineComplianceEntity({
@@ -612,7 +612,7 @@ var PaymentLink = defineComplianceEntity({
     paymentMethods: fp.enum().array().compliance("none"),
     currency: fp.enum().compliance("none"),
     status: fp.enum().compliance("none"),
-    providerFields: fp.json().compliance("none")
+    providerFields: fp.json().compliance("pci")
   }
 });
 var Plan = defineComplianceEntity({
@@ -625,7 +625,7 @@ var Plan = defineComplianceEntity({
     cadence: fp.enum().compliance("none"),
     currency: fp.enum().compliance("none"),
     billingProvider: fp.enum().compliance("none"),
-    providerFields: fp.json().compliance("none")
+    providerFields: fp.json().compliance("pci")
   }
 });
 var Subscription = defineComplianceEntity({
@@ -637,7 +637,7 @@ var Subscription = defineComplianceEntity({
     partyType: fp.enum().compliance("none"),
     billingProvider: fp.enum().compliance("none"),
     active: fp.boolean().compliance("none"),
-    providerFields: fp.json().compliance("none")
+    providerFields: fp.json().compliance("pci")
   }
 });
 var StripeWebhookEvent = defineComplianceEntity({
@@ -649,7 +649,7 @@ var StripeWebhookEvent = defineComplianceEntity({
     stripeId: fp.string().compliance("none"),
     idempotencyKey: fp.string().nullable().compliance("none"),
     eventType: fp.string().compliance("none"),
-    eventData: fp.json().compliance("none")
+    eventData: fp.json().compliance("pci")
   }
 });
 
@@ -660,7 +660,7 @@ var BillingProviderEnum = {
 
 // services/webhook.service.ts
 var StripeWebhookService = class {
-  defaultPartyType;
+  partyEnum;
   stripeClient;
   em;
   schemaValidator;
@@ -670,8 +670,8 @@ var StripeWebhookService = class {
   paymentLinkService;
   planService;
   subscriptionService;
-  constructor(stripeClient, em, schemaValidator, openTelemetryCollector, billingPortalService, checkoutSessionService, paymentLinkService, planService, subscriptionService, defaultPartyType) {
-    this.defaultPartyType = defaultPartyType;
+  constructor(stripeClient, em, schemaValidator, openTelemetryCollector, billingPortalService, checkoutSessionService, paymentLinkService, planService, subscriptionService, partyEnum) {
+    this.partyEnum = partyEnum;
     this.stripeClient = stripeClient;
     this.em = em;
     this.schemaValidator = schemaValidator;
@@ -682,6 +682,16 @@ var StripeWebhookService = class {
     this.planService = planService;
     this.subscriptionService = subscriptionService;
   }
+  /**
+   * Resolve the party type for a subscription event.
+   * Stripe subscriptions are customer-scoped — customers map to users
+   * by default. Override this method to implement organization-level
+   * subscriptions or other party resolution logic.
+   */
+  resolvePartyType(_event) {
+    const keys = Object.keys(this.partyEnum);
+    return this.partyEnum[keys[0]];
+  }
   /**
    * Extract features from Stripe product metadata.
    * Features can be stored as:
@@ -890,7 +900,7 @@ var StripeWebhookService = class {
           {
             id: event.data.object.id,
             partyId: typeof event.data.object.customer === "string" ? event.data.object.customer : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? void 0,
             active: true,
             productId: event.data.object.items.data[0].plan.id,
@@ -913,7 +923,7 @@ var StripeWebhookService = class {
           {
             id: event.data.object.id,
             partyId: typeof event.data.object.customer === "string" ? event.data.object.customer : event.data.object.customer.id,
-            partyType: this.defaultPartyType,
+            partyType: this.resolvePartyType(event),
             description: event.data.object.description ?? void 0,
             active: true,
             externalId: event.data.object.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/implementation-billing-stripe",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Stripe implementation for forklaunch billing",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -42,20 +42,20 @@
     "lib/**"
   ],
   "dependencies": {
-    "@forklaunch/common": "^1.0.13",
-    "@forklaunch/core": "^1.0.13",
-    "@forklaunch/internal": "^1.0.13",
-    "@forklaunch/validator": "^1.0.13",
+    "@forklaunch/common": "^1.1.0",
+    "@forklaunch/core": "^1.1.0",
+    "@forklaunch/internal": "^1.1.0",
+    "@forklaunch/validator": "^1.1.0",
     "@mikro-orm/core": "7.0.5",
     "@sinclair/typebox": "^0.34.48",
     "ajv": "^8.18.0",
     "stripe": "^20.4.1",
     "zod": "^4.3.6",
-    "@forklaunch/implementation-billing-base": "1.0.0",
-    "@forklaunch/interfaces-billing": "1.0.0"
+    "@forklaunch/implementation-billing-base": "1.0.1",
+    "@forklaunch/interfaces-billing": "1.0.1"
   },
   "devDependencies": {
-    "@typescript/native-preview": "7.0.0-dev.20260320.1",
+    "@typescript/native-preview": "7.0.0-dev.20260324.1",
     "depcheck": "^1.4.7",
     "prettier": "^3.8.1",
     "typedoc": "^0.28.18"