@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.custom-ops.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Subscription Mutations Custom Implementations
+ *
+ * Implements CANCEL, RESUME, CHANGE_PLAN, ADD_ADDON, REMOVE_ADDON operations
+ * on subscription polymorphic variants.
+ *
+ * Pattern: PREFIX_CORE_OPERATIONS
+ *   PREFIX  → validate, call billing provider (Stripe), return update payload
+ *   CORE    → standard UPDATE (engine handles DB write)
+ *   Feature sync is handled automatically by the post-operation hook infrastructure.
+ *
+ * One factory per polymorphic variant (org, user) per operation.
+ * All variants share the same handler logic.
+ *
+ * @see billing-polymorphic-full-implementation.md §4.2 + §4.3
+ */
+import { type ResourceCustomServiceImplementationFactory } from '../../../base-classes/services/services/resource-operation-custom-implementation.factory.backend.js';
+export declare function createSubscriptionCancelFactories(): ResourceCustomServiceImplementationFactory[];
+/**
+ * Create RESUME custom impl factories for all subscription variants.
+ *
+ * RESUME un-cancels a subscription that has cancelAtPeriodEnd = true.
+ *   PREFIX:  validates subscription is pending cancellation, calls provider resumeSubscription()
+ *   CORE:    standard UPDATE clears cancellation fields
+ *   (Feature sync handled by post-operation hook)
+ */
+export declare function createSubscriptionResumeFactories(): ResourceCustomServiceImplementationFactory[];
+/**
+ * Create CHANGE_PLAN custom impl factories for all subscription variants.
+ *
+ * CHANGE_PLAN upgrades or downgrades the subscription plan.
+ *   PREFIX:  resolves new product/price, determines proration, builds provider items,
+ *            calls provider updateSubscription(), returns update payload with new items
+ *   CORE:    standard UPDATE writes new items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export declare function createSubscriptionChangePlanFactories(): ResourceCustomServiceImplementationFactory[];
+/**
+ * Create ADD_ADDON custom impl factories for all subscription variants.
+ *
+ * ADD_ADDON adds an addon product to the existing subscription.
+ *   PREFIX:  validates addon product (type, requiredPlanTiers), builds provider items,
+ *            calls provider updateSubscription(), returns update payload with expanded items
+ *   CORE:    standard UPDATE writes new items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export declare function createSubscriptionAddAddonFactories(): ResourceCustomServiceImplementationFactory[];
+/**
+ * Create REMOVE_ADDON custom impl factories for all subscription variants.
+ *
+ * REMOVE_ADDON removes an addon product from the subscription.
+ *   PREFIX:  finds addon item, builds remaining items, calls provider updateSubscription(),
+ *            returns update payload with remaining items
+ *   CORE:    standard UPDATE writes remaining items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export declare function createSubscriptionRemoveAddonFactories(): ResourceCustomServiceImplementationFactory[];
+//# sourceMappingURL=subscription.mutations.custom-impl.backend.service.d.ts.map

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.mutations.custom-impl.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAsBpH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CAqChG;AAMD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CAwChG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,IAAI,0CAA0C,EAAE,CA6GpG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,IAAI,0CAA0C,EAAE,CAqFlG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,IAAI,0CAA0C,EAAE,CA8CrG"}

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.js

@@ -0,0 +1,362 @@
+/**
+ * Subscription Mutations Custom Implementations
+ *
+ * Implements CANCEL, RESUME, CHANGE_PLAN, ADD_ADDON, REMOVE_ADDON operations
+ * on subscription polymorphic variants.
+ *
+ * Pattern: PREFIX_CORE_OPERATIONS
+ *   PREFIX  → validate, call billing provider (Stripe), return update payload
+ *   CORE    → standard UPDATE (engine handles DB write)
+ *   Feature sync is handled automatically by the post-operation hook infrastructure.
+ *
+ * One factory per polymorphic variant (org, user) per operation.
+ * All variants share the same handler logic.
+ *
+ * @see billing-polymorphic-full-implementation.md §4.2 + §4.3
+ */
+import { CoreResourceType, ResourceOperationVariantType, SubscriptionStatus, ErrorType, ErrorCustomMessageReference, ProductType, ProrationBehavior, BillingTiming, BillingSubscription_Operations, BillingSubscription_CancelRequestDto, BillingSubscription_ChangePlanRequestDto, BillingSubscription_AddAddonRequestDto, BillingSubscription_RemoveAddonRequestDto, } from '@wildo-ai/saas-models';
+import { createResourceCustomServiceImplementation, } from '../../../base-classes/services/services/resource-operation-custom-implementation.factory.backend.js';
+import { getBillingProvider, getBillingConfig } from '../../../billing/services/custom-impl/billing-custom-implementations.backend.js';
+import { readProductByKey, readProductById, readPriceById, validateProviderSubscription, resolveProviderItems, } from '../../../billing/services/custom-impl/billing-custom-impl-utils.backend.js';
+// ── Subscription polymorphic variant types ───────────────────────────
+const SUBSCRIPTION_VARIANT_TYPES = [
+    CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,
+    CoreResourceType.USER_SUBSCRIPTIONS,
+];
+// ════════════════════════════════════════════════════════════════════
+// CANCEL
+// ════════════════════════════════════════════════════════════════════
+export function createSubscriptionCancelFactories() {
+    return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: variantResourceType,
+                    operationIdentifier: BillingSubscription_Operations.CANCEL,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                requestDtoSchema: BillingSubscription_CancelRequestDto,
+                handlers: {
+                    prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {
+                        const subscription = utils.currentObject;
+                        validateProviderSubscription(subscription, _id, executionContext, utils);
+                        const cancelImmediately = input.cancelImmediately;
+                        const atPeriodEnd = !cancelImmediately;
+                        const provider = getBillingProvider();
+                        await provider.cancelSubscription(subscription.providerSubscriptionId, { atPeriodEnd });
+                        return {
+                            cancelAtPeriodEnd: atPeriodEnd,
+                            cancelledAt: new Date(),
+                            ...(!atPeriodEnd && { status: SubscriptionStatus.CANCELLED }),
+                            ...(input.reason && { cancellationReason: input.reason }),
+                        };
+                    },
+                    // Feature sync is handled automatically by the post-operation hook infrastructure
+                },
+            });
+        };
+        return factory;
+    });
+}
+// ════════════════════════════════════════════════════════════════════
+// RESUME
+// ════════════════════════════════════════════════════════════════════
+/**
+ * Create RESUME custom impl factories for all subscription variants.
+ *
+ * RESUME un-cancels a subscription that has cancelAtPeriodEnd = true.
+ *   PREFIX:  validates subscription is pending cancellation, calls provider resumeSubscription()
+ *   CORE:    standard UPDATE clears cancellation fields
+ *   (Feature sync handled by post-operation hook)
+ */
+export function createSubscriptionResumeFactories() {
+    return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: variantResourceType,
+                    operationIdentifier: BillingSubscription_Operations.RESUME,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                handlers: {
+                    prefixCoreOperations: async (_id, _input, executionContext, _operationPath, utils) => {
+                        const subscription = utils.currentObject;
+                        validateProviderSubscription(subscription, _id, executionContext, utils);
+                        if (!subscription.cancelAtPeriodEnd) {
+                            throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {
+                                customMessageReference: ErrorCustomMessageReference.BILLING_NO_ACTIVE_SUBSCRIPTION,
+                                context: { subscriptionId: _id, reason: 'Subscription is not pending cancellation' },
+                            });
+                        }
+                        const provider = getBillingProvider();
+                        await provider.resumeSubscription(subscription.providerSubscriptionId);
+                        return {
+                            cancelAtPeriodEnd: false,
+                            cancelledAt: null,
+                            cancellationReason: null,
+                            status: SubscriptionStatus.ACTIVE,
+                        };
+                    },
+                    // Feature sync is handled automatically by the post-operation hook infrastructure
+                },
+            });
+        };
+        return factory;
+    });
+}
+// ════════════════════════════════════════════════════════════════════
+// CHANGE_PLAN
+// ════════════════════════════════════════════════════════════════════
+/**
+ * Create CHANGE_PLAN custom impl factories for all subscription variants.
+ *
+ * CHANGE_PLAN upgrades or downgrades the subscription plan.
+ *   PREFIX:  resolves new product/price, determines proration, builds provider items,
+ *            calls provider updateSubscription(), returns update payload with new items
+ *   CORE:    standard UPDATE writes new items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export function createSubscriptionChangePlanFactories() {
+    return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: variantResourceType,
+                    operationIdentifier: BillingSubscription_Operations.CHANGE_PLAN,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                requestDtoSchema: BillingSubscription_ChangePlanRequestDto,
+                handlers: {
+                    prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {
+                        const subscription = utils.currentObject;
+                        validateProviderSubscription(subscription, _id, executionContext, utils);
+                        const newProduct = await readProductByKey(input.newProductKey, executionContext, utils);
+                        const newPrice = await readPriceById(input.newPriceId, executionContext, utils);
+                        if (!newPrice.providerPriceId) {
+                            throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {
+                                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,
+                                context: { priceId: input.newPriceId, productKey: input.newProductKey },
+                            });
+                        }
+                        // Find the current plan item (type === PLAN) and determine upgrade/downgrade
+                        let planItemIndex = -1;
+                        for (let i = 0; i < subscription.items.length; i++) {
+                            const itemProduct = await readProductById(subscription.items[i].productId, executionContext, utils);
+                            if (itemProduct.type === ProductType.PLAN) {
+                                planItemIndex = i;
+                                break;
+                            }
+                        }
+                        // Build provider items: replace plan item, preserve addons
+                        const providerItems = [];
+                        const localItems = [];
+                        for (let i = 0; i < subscription.items.length; i++) {
+                            if (i === planItemIndex) {
+                                providerItems.push({
+                                    providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,
+                                    providerPriceId: newPrice.providerPriceId,
+                                    quantity: 1,
+                                });
+                                localItems.push({
+                                    _id: subscription.items[i]._id,
+                                    productId: newProduct._id,
+                                    priceId: newPrice._id,
+                                    quantity: 1,
+                                });
+                            }
+                            else {
+                                const price = await readPriceById(subscription.items[i].priceId, executionContext, utils);
+                                providerItems.push({
+                                    providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,
+                                    providerPriceId: price.providerPriceId || subscription.items[i].priceId,
+                                    quantity: subscription.items[i].quantity,
+                                });
+                                localItems.push(subscription.items[i]);
+                            }
+                        }
+                        // If no plan item found, prepend the new plan
+                        if (planItemIndex === -1) {
+                            providerItems.unshift({ providerPriceId: newPrice.providerPriceId, quantity: 1 });
+                            localItems.unshift({
+                                _id: `${subscription.providerSubscriptionId}_item_plan`,
+                                productId: newProduct._id,
+                                priceId: newPrice._id,
+                                quantity: 1,
+                            });
+                        }
+                        // Determine proration from product behavior policy
+                        const currentProduct = planItemIndex >= 0
+                            ? await readProductById(subscription.items[planItemIndex].productId, executionContext, utils)
+                            : null;
+                        const isUpgrade = currentProduct
+                            ? (newProduct.planTierOrder ?? 0) > (currentProduct.planTierOrder ?? 0)
+                            : true;
+                        const config = getBillingConfig();
+                        const policy = isUpgrade
+                            ? (newProduct.behaviorPolicy?.upgrade ?? { proration: config.defaultBehaviorPolicy.defaultProration, timing: BillingTiming.IMMEDIATE })
+                            : (newProduct.behaviorPolicy?.downgrade ?? { proration: ProrationBehavior.NONE, timing: BillingTiming.AT_PERIOD_END });
+                        const provider = getBillingProvider();
+                        await provider.updateSubscription(subscription.providerSubscriptionId, {
+                            items: providerItems,
+                            metadata: {
+                                prorationBehavior: policy.proration,
+                                // Timing is captured for provider connectors that support deferred changes
+                                // (e.g., Stripe subscription schedules). Connectors that don't support it
+                                // will ignore the field and apply the change immediately.
+                                prorationTiming: policy.timing,
+                            },
+                        });
+                        return { items: localItems };
+                    },
+                    // Feature sync is handled automatically by the post-operation hook infrastructure
+                },
+            });
+        };
+        return factory;
+    });
+}
+// ════════════════════════════════════════════════════════════════════
+// ADD_ADDON
+// ════════════════════════════════════════════════════════════════════
+/**
+ * Create ADD_ADDON custom impl factories for all subscription variants.
+ *
+ * ADD_ADDON adds an addon product to the existing subscription.
+ *   PREFIX:  validates addon product (type, requiredPlanTiers), builds provider items,
+ *            calls provider updateSubscription(), returns update payload with expanded items
+ *   CORE:    standard UPDATE writes new items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export function createSubscriptionAddAddonFactories() {
+    return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: variantResourceType,
+                    operationIdentifier: BillingSubscription_Operations.ADD_ADDON,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                requestDtoSchema: BillingSubscription_AddAddonRequestDto,
+                handlers: {
+                    prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {
+                        const subscription = utils.currentObject;
+                        validateProviderSubscription(subscription, _id, executionContext, utils);
+                        // Resolve addon product and validate
+                        const addonProduct = await readProductByKey(input.addonProductKey, executionContext, utils);
+                        if (addonProduct.type !== ProductType.ADDON) {
+                            throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                                customMessageReference: ErrorCustomMessageReference.BILLING_INVALID_PRODUCT_TYPE,
+                                context: { productKey: input.addonProductKey, expectedType: ProductType.ADDON, actualType: addonProduct.type },
+                            });
+                        }
+                        // Validate requiredPlanTiers
+                        if (addonProduct.requiredPlanTiers && addonProduct.requiredPlanTiers.length > 0) {
+                            let currentPlanTier;
+                            for (const item of subscription.items) {
+                                const itemProduct = await readProductById(item.productId, executionContext, utils);
+                                if (itemProduct.type === ProductType.PLAN) {
+                                    currentPlanTier = itemProduct.planTier;
+                                    break;
+                                }
+                            }
+                            if (!currentPlanTier || !addonProduct.requiredPlanTiers.includes(currentPlanTier)) {
+                                throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {
+                                    customMessageReference: ErrorCustomMessageReference.BILLING_PLAN_TIER_REQUIRED,
+                                    context: { addonProductKey: input.addonProductKey, requiredTiers: addonProduct.requiredPlanTiers, currentTier: currentPlanTier ?? null },
+                                });
+                            }
+                        }
+                        // Resolve addon price
+                        const addonPrice = await readPriceById(input.priceId, executionContext, utils);
+                        if (!addonPrice.providerPriceId) {
+                            throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {
+                                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,
+                                context: { priceId: input.priceId, productKey: input.addonProductKey },
+                            });
+                        }
+                        // Build provider items: existing items + new addon
+                        const existingProviderItems = await resolveProviderItems(subscription.items, executionContext, utils);
+                        existingProviderItems.push({
+                            providerPriceId: addonPrice.providerPriceId,
+                            quantity: 1,
+                        });
+                        const provider = getBillingProvider();
+                        await provider.updateSubscription(subscription.providerSubscriptionId, {
+                            items: existingProviderItems,
+                        });
+                        // Build local items with the new addon appended
+                        const newItems = [
+                            ...subscription.items,
+                            {
+                                _id: `${subscription.providerSubscriptionId}_item_${subscription.items.length}`,
+                                productId: addonProduct._id,
+                                priceId: addonPrice._id,
+                                quantity: 1,
+                            },
+                        ];
+                        return { items: newItems };
+                    },
+                    // Feature sync is handled automatically by the post-operation hook infrastructure
+                },
+            });
+        };
+        return factory;
+    });
+}
+// ════════════════════════════════════════════════════════════════════
+// REMOVE_ADDON
+// ════════════════════════════════════════════════════════════════════
+/**
+ * Create REMOVE_ADDON custom impl factories for all subscription variants.
+ *
+ * REMOVE_ADDON removes an addon product from the subscription.
+ *   PREFIX:  finds addon item, builds remaining items, calls provider updateSubscription(),
+ *            returns update payload with remaining items
+ *   CORE:    standard UPDATE writes remaining items to DB
+ *   (Feature sync handled by post-operation hook)
+ */
+export function createSubscriptionRemoveAddonFactories() {
+    return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: variantResourceType,
+                    operationIdentifier: BillingSubscription_Operations.REMOVE_ADDON,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                requestDtoSchema: BillingSubscription_RemoveAddonRequestDto,
+                handlers: {
+                    prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {
+                        const subscription = utils.currentObject;
+                        validateProviderSubscription(subscription, _id, executionContext, utils);
+                        // Resolve addon product
+                        const addonProduct = await readProductByKey(input.addonProductKey, executionContext, utils);
+                        // Find and remove the addon item
+                        const remainingItems = subscription.items.filter((item) => item.productId !== addonProduct._id);
+                        if (remainingItems.length === subscription.items.length) {
+                            throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {
+                                customMessageReference: ErrorCustomMessageReference.BILLING_ADDON_NOT_ON_SUBSCRIPTION,
+                                context: { addonProductKey: input.addonProductKey, subscriptionId: _id },
+                            });
+                        }
+                        // Build provider items from remaining items
+                        const providerItems = await resolveProviderItems(remainingItems, executionContext, utils);
+                        const provider = getBillingProvider();
+                        await provider.updateSubscription(subscription.providerSubscriptionId, {
+                            items: providerItems,
+                        });
+                        return { items: remainingItems };
+                    },
+                    // Feature sync is handled automatically by the post-operation hook infrastructure
+                },
+            });
+        };
+        return factory;
+    });
+}
+//# sourceMappingURL=subscription.mutations.custom-impl.backend.service.js.map

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.mutations.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/billing/services/webhooks/billing-webhook-adapter.backend.service.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Billing Webhook Adapter
+ *
+ * Bridges StandardBilling_Interface methods (verifyWebhookSignature, parseWebhookEvent)
+ * to the generic WebhookCapabilityAdapter interface used by WebhookHandlerBackendService.
+ *
+ * This adapter wraps the existing billing transformer without modifying it.
+ *
+ * @see hook-protocol-webhook-callback.md §Step 4d
+ */
+import type { StandardBilling_Interface, WebhookCapabilityAdapter, StandardHook_ParsedEvent } from '@wildo-ai/external-connectors-models';
+export declare class BillingWebhookAdapter implements WebhookCapabilityAdapter {
+    private readonly billingProvider;
+    private readonly providerRef;
+    constructor(billingProvider: StandardBilling_Interface, providerRef: string);
+    verifySignature(rawBody: string | Buffer, signatureHeader: string, secret: string): boolean;
+    parseEvent(rawBody: string | Buffer, _headers: Record<string, string>): StandardHook_ParsedEvent | null;
+}
+//# sourceMappingURL=billing-webhook-adapter.backend.service.d.ts.map

package/dist/esm/billing/services/webhooks/billing-webhook-adapter.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-webhook-adapter.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/webhooks/billing-webhook-adapter.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAE9C,qBAAa,qBAAsB,YAAW,wBAAwB;IAElE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,eAAe,EAAE,yBAAyB,EAC1C,WAAW,EAAE,MAAM;IAGtC,eAAe,CACb,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,OAAO;IAQV,UAAU,CACR,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,wBAAwB,GAAG,IAAI;CA+BnC"}

package/dist/esm/billing/services/webhooks/billing-webhook-adapter.backend.service.js

@@ -0,0 +1,50 @@
+/**
+ * Billing Webhook Adapter
+ *
+ * Bridges StandardBilling_Interface methods (verifyWebhookSignature, parseWebhookEvent)
+ * to the generic WebhookCapabilityAdapter interface used by WebhookHandlerBackendService.
+ *
+ * This adapter wraps the existing billing transformer without modifying it.
+ *
+ * @see hook-protocol-webhook-callback.md §Step 4d
+ */
+export class BillingWebhookAdapter {
+    billingProvider;
+    providerRef;
+    constructor(billingProvider, providerRef) {
+        this.billingProvider = billingProvider;
+        this.providerRef = providerRef;
+    }
+    verifySignature(rawBody, signatureHeader, secret) {
+        return this.billingProvider.verifyWebhookSignature(typeof rawBody === 'string' ? rawBody : rawBody.toString('utf-8'), signatureHeader, secret);
+    }
+    parseEvent(rawBody, _headers) {
+        const rawString = typeof rawBody === 'string' ? rawBody : rawBody.toString('utf-8');
+        // Parse the raw body to extract the native provider event type (e.g., 'customer.subscription.created')
+        // and the full payload for scope resolution via dot-path extraction.
+        let rawPayload;
+        try {
+            rawPayload = JSON.parse(rawString);
+        }
+        catch {
+            rawPayload = {};
+        }
+        // Extract the native provider event type BEFORE the billing transformer maps it.
+        // This is critical for scope-exempt event matching (scopeExemptEventTypes uses native types).
+        const nativeEventType = typeof rawPayload.type === 'string' ? rawPayload.type : '';
+        const billingEvent = this.billingProvider.parseWebhookEvent(rawString);
+        if (!billingEvent)
+            return null;
+        return {
+            eventId: billingEvent.providerEventId,
+            eventType: billingEvent.type, // Standardized: e.g., 'subscription.created'
+            providerEventType: nativeEventType, // Native: e.g., 'customer.subscription.created'
+            providerRef: this.providerRef,
+            endpointKey: 'billing',
+            payload: billingEvent.data,
+            rawPayload,
+            timestamp: billingEvent.createdAt,
+        };
+    }
+}
+//# sourceMappingURL=billing-webhook-adapter.backend.service.js.map

package/dist/esm/billing/services/webhooks/billing-webhook-adapter.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-webhook-adapter.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/webhooks/billing-webhook-adapter.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,eAA0C,EAC1C,WAAmB;QADnB,oBAAe,GAAf,eAAe,CAA2B;QAC1C,gBAAW,GAAX,WAAW,CAAQ;IACnC,CAAC;IAEJ,eAAe,CACb,OAAwB,EACxB,eAAuB,EACvB,MAAc;QAEd,OAAO,IAAI,CAAC,eAAe,CAAC,sBAAsB,CAChD,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EACjE,eAAe,EACf,MAAM,CACP,CAAC;IACJ,CAAC;IAED,UAAU,CACR,OAAwB,EACxB,QAAgC;QAEhC,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEpF,uGAAuG;QACvG,qEAAqE;QACrE,IAAI,UAAmC,CAAC;QACxC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,EAAE,CAAC;QAClB,CAAC;QAED,iFAAiF;QACjF,8FAA8F;QAC9F,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnF,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE/B,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,eAAe;YACrC,SAAS,EAAE,YAAY,CAAC,IAAI,EAAe,6CAA6C;YACxF,iBAAiB,EAAE,eAAe,EAAS,gDAAgD;YAC3F,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,YAAY,CAAC,IAAI;YAC1B,UAAU;YACV,SAAS,EAAE,YAAY,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/billing/services/webhooks/billing-webhook-capability-handler.backend.service.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Billing Webhook Capability Handler
+ *
+ * Dispatches processed webhook events to the BillingWebhookEventRouter,
+ * which routes each event to the appropriate resource operations on the
+ * correct polymorphic variants.
+ *
+ * Bridges the generic WebhookCapabilityHandler interface to the
+ * resource-centric billing webhook event router.
+ *
+ * @see billing-polymorphic-full-implementation.md §4.5
+ */
+import { ExternalProvider_Capability, type WebhookCapabilityHandler, type StandardHook_ParsedEvent } from '@wildo-ai/external-connectors-models';
+import type { BillingWebhookEventRouterBackendService } from '../../../billing/services/webhooks/billing-webhook-event-router.backend.service.js';
+export declare class BillingWebhookCapabilityHandler implements WebhookCapabilityHandler {
+    private readonly router;
+    readonly capability = ExternalProvider_Capability.BILLING;
+    constructor(router: BillingWebhookEventRouterBackendService);
+    handleEvent(executionContext: unknown, parsedEvent: StandardHook_ParsedEvent): Promise<void>;
+}
+//# sourceMappingURL=billing-webhook-capability-handler.backend.service.d.ts.map

package/dist/esm/billing/services/webhooks/billing-webhook-capability-handler.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-webhook-capability-handler.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/webhooks/billing-webhook-capability-handler.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAG9B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,2FAA2F,CAAC;AAEzJ,qBAAa,+BAAgC,YAAW,wBAAwB;IAI5E,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,QAAQ,CAAC,UAAU,uCAAuC;gBAGvC,MAAM,EAAE,uCAAuC;IAG5D,WAAW,CACf,gBAAgB,EAAE,OAAO,EACzB,WAAW,EAAE,wBAAwB,GACpC,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/dist/esm/billing/services/webhooks/billing-webhook-capability-handler.backend.service.js

@@ -0,0 +1,32 @@
+/**
+ * Billing Webhook Capability Handler
+ *
+ * Dispatches processed webhook events to the BillingWebhookEventRouter,
+ * which routes each event to the appropriate resource operations on the
+ * correct polymorphic variants.
+ *
+ * Bridges the generic WebhookCapabilityHandler interface to the
+ * resource-centric billing webhook event router.
+ *
+ * @see billing-polymorphic-full-implementation.md §4.5
+ */
+import { ExternalProvider_Capability, } from '@wildo-ai/external-connectors-models';
+export class BillingWebhookCapabilityHandler {
+    router;
+    capability = ExternalProvider_Capability.BILLING;
+    constructor(router) {
+        this.router = router;
+    }
+    async handleEvent(executionContext, parsedEvent) {
+        // Reconstruct the StandardBilling_WebhookEvent expected by the router
+        const billingEvent = {
+            type: parsedEvent.eventType,
+            providerEventId: parsedEvent.eventId,
+            data: parsedEvent.payload ?? {},
+            createdAt: parsedEvent.timestamp instanceof Date ? parsedEvent.timestamp : new Date(parsedEvent.timestamp),
+        };
+        // Dispatch to router with the WEBHOOK_CALLBACK execution context
+        await this.router.routeEvent(billingEvent, executionContext);
+    }
+}
+//# sourceMappingURL=billing-webhook-capability-handler.backend.service.js.map

package/dist/esm/billing/services/webhooks/billing-webhook-capability-handler.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-webhook-capability-handler.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/webhooks/billing-webhook-capability-handler.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,2BAA2B,GAK5B,MAAM,sCAAsC,CAAC;AAI9C,MAAM,OAAO,+BAA+B;IAIvB;IAHV,UAAU,GAAG,2BAA2B,CAAC,OAAO,CAAC;IAE1D,YACmB,MAA+C;QAA/C,WAAM,GAAN,MAAM,CAAyC;IAC/D,CAAC;IAEJ,KAAK,CAAC,WAAW,CACf,gBAAyB,EACzB,WAAqC;QAErC,sEAAsE;QACtE,MAAM,YAAY,GAAiC;YACjD,IAAI,EAAE,WAAW,CAAC,SAAsC;YACxD,eAAe,EAAE,WAAW,CAAC,OAAO;YACpC,IAAI,EAAG,WAAW,CAAC,OAAmC,IAAI,EAAE;YAC5D,SAAS,EAAE,WAAW,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;SAC3G,CAAC;QAEF,iEAAiE;QACjE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,gBAAyC,CAAC,CAAC;IACxF,CAAC;CACF"}