@powerhousedao/service-offering 1.0.0-dev.4 → 1.0.0-dev.6

package/dist/document-models/service-offering/v1/src/reducers/tiers.js

@@ -1,3 +1,4 @@
+import { UpdateTierNotFoundError, UpdateTierPricingNotFoundError, DeleteTierNotFoundError, AddServiceLevelTierNotFoundError, UpdateServiceLevelTierNotFoundError, UpdateServiceLevelNotFoundError, RemoveServiceLevelTierNotFoundError, AddUsageLimitTierNotFoundError, UpdateUsageLimitTierNotFoundError, UpdateUsageLimitNotFoundError, RemoveUsageLimitTierNotFoundError, SetTierDefaultBillingCycleTierNotFoundError, SetTierBillingCycleDiscountsTierNotFoundError, SetTierPricingModeTierNotFoundError, } from "../../gen/tiers/error.js";
 export const serviceOfferingTiersOperations = {
     addTierOperation(state, action) {
         state.tiers.push({
@@ -5,8 +6,11 @@ export const serviceOfferingTiersOperations = {
             name: action.input.name,
             description: action.input.description || null,
             isCustomPricing: action.input.isCustomPricing || false,
-            pricingMode: "FIXED",
-            pricing: null,
+            pricingMode: null,
+            pricing: {
+                amount: action.input.amount || null,
+                currency: action.input.currency,
+            },
             defaultBillingCycle: null,
             billingCycleDiscounts: [],
             serviceLevels: [],
@@ -16,135 +20,164 @@ export const serviceOfferingTiersOperations = {
     },
     updateTierOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.id);
-        if (tier) {
-            if (action.input.name)
-                tier.name = action.input.name;
-            if (action.input.description !== undefined)
-                tier.description = action.input.description || null;
-            if (action.input.isCustomPricing !== undefined &&
-                action.input.isCustomPricing !== null)
-                tier.isCustomPricing = action.input.isCustomPricing;
+        if (!tier) {
+            throw new UpdateTierNotFoundError(`Tier with ID ${action.input.id} not found`);
         }
+        if (action.input.name)
+            tier.name = action.input.name;
+        if (action.input.description !== undefined)
+            tier.description = action.input.description || null;
+        if (action.input.isCustomPricing !== undefined &&
+            action.input.isCustomPricing !== null)
+            tier.isCustomPricing = action.input.isCustomPricing;
         state.lastModified = action.input.lastModified;
     },
     updateTierPricingOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            if (!tier.pricing) {
-                tier.pricing = {
-                    amount: action.input.amount,
-                    currency: action.input.currency,
-                };
-            }
-            else {
-                tier.pricing.amount = action.input.amount;
-                tier.pricing.currency = action.input.currency;
-            }
+        if (!tier) {
+            throw new UpdateTierPricingNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        if (action.input.amount !== undefined)
+            tier.pricing.amount = action.input.amount || null;
+        if (action.input.currency)
+            tier.pricing.currency = action.input.currency;
         state.lastModified = action.input.lastModified;
     },
     deleteTierOperation(state, action) {
         const index = state.tiers.findIndex((t) => t.id === action.input.id);
-        if (index !== -1) {
-            state.tiers.splice(index, 1);
+        if (index === -1) {
+            throw new DeleteTierNotFoundError(`Tier with ID ${action.input.id} not found`);
         }
+        state.tiers.splice(index, 1);
         state.lastModified = action.input.lastModified;
     },
     addServiceLevelOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            tier.serviceLevels.push({
-                id: action.input.id,
-                serviceId: action.input.serviceId,
-                level: action.input.level,
-                description: action.input.description || null,
-            });
+        if (!tier) {
+            throw new AddServiceLevelTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        tier.serviceLevels.push({
+            id: action.input.serviceLevelId,
+            serviceId: action.input.serviceId,
+            level: action.input.level,
+            customValue: action.input.customValue || null,
+            optionGroupId: action.input.optionGroupId || null,
+        });
         state.lastModified = action.input.lastModified;
     },
     updateServiceLevelOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            const sl = tier.serviceLevels.find((s) => s.id === action.input.id);
-            if (sl) {
-                if (action.input.level)
-                    sl.level = action.input.level;
-                if (action.input.description !== undefined)
-                    sl.description = action.input.description || null;
-            }
+        if (!tier) {
+            throw new UpdateServiceLevelTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        const sl = tier.serviceLevels.find((s) => s.id === action.input.serviceLevelId);
+        if (!sl) {
+            throw new UpdateServiceLevelNotFoundError(`Service level with ID ${action.input.serviceLevelId} not found`);
+        }
+        if (action.input.level)
+            sl.level = action.input.level;
+        if (action.input.customValue !== undefined)
+            sl.customValue = action.input.customValue || null;
+        if (action.input.optionGroupId !== undefined)
+            sl.optionGroupId = action.input.optionGroupId || null;
         state.lastModified = action.input.lastModified;
     },
     removeServiceLevelOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            const index = tier.serviceLevels.findIndex((s) => s.id === action.input.id);
-            if (index !== -1) {
-                tier.serviceLevels.splice(index, 1);
-            }
+        if (!tier) {
+            throw new RemoveServiceLevelTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
+        }
+        const index = tier.serviceLevels.findIndex((s) => s.id === action.input.serviceLevelId);
+        if (index !== -1) {
+            tier.serviceLevels.splice(index, 1);
         }
         state.lastModified = action.input.lastModified;
     },
     addUsageLimitOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            tier.usageLimits.push({
-                id: action.input.id,
-                name: action.input.name,
-                limit: action.input.limit,
-                unit: action.input.unit || null,
-            });
+        if (!tier) {
+            throw new AddUsageLimitTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        tier.usageLimits.push({
+            id: action.input.limitId,
+            serviceId: action.input.serviceId,
+            metric: action.input.metric,
+            unitName: action.input.unitName || null,
+            freeLimit: action.input.freeLimit || null,
+            paidLimit: action.input.paidLimit || null,
+            resetCycle: action.input.resetCycle || null,
+            notes: action.input.notes || null,
+            unitPrice: action.input.unitPrice || null,
+            unitPriceCurrency: action.input.unitPriceCurrency || null,
+        });
         state.lastModified = action.input.lastModified;
     },
     updateUsageLimitOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            const ul = tier.usageLimits.find((u) => u.id === action.input.id);
-            if (ul) {
-                if (action.input.limit !== undefined && action.input.limit !== null)
-                    ul.limit = action.input.limit;
-                if (action.input.name !== undefined && action.input.name !== null)
-                    ul.name = action.input.name;
-                if (action.input.unit !== undefined)
-                    ul.unit = action.input.unit || null;
-            }
+        if (!tier) {
+            throw new UpdateUsageLimitTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        const ul = tier.usageLimits.find((u) => u.id === action.input.limitId);
+        if (!ul) {
+            throw new UpdateUsageLimitNotFoundError(`Usage limit with ID ${action.input.limitId} not found`);
+        }
+        if (action.input.metric)
+            ul.metric = action.input.metric;
+        if (action.input.unitName !== undefined)
+            ul.unitName = action.input.unitName || null;
+        if (action.input.freeLimit !== undefined)
+            ul.freeLimit = action.input.freeLimit || null;
+        if (action.input.paidLimit !== undefined)
+            ul.paidLimit = action.input.paidLimit || null;
+        if (action.input.resetCycle !== undefined)
+            ul.resetCycle = action.input.resetCycle || null;
+        if (action.input.notes !== undefined)
+            ul.notes = action.input.notes || null;
+        if (action.input.unitPrice !== undefined)
+            ul.unitPrice = action.input.unitPrice || null;
+        if (action.input.unitPriceCurrency !== undefined)
+            ul.unitPriceCurrency = action.input.unitPriceCurrency || null;
         state.lastModified = action.input.lastModified;
     },
     removeUsageLimitOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            const index = tier.usageLimits.findIndex((u) => u.id === action.input.id);
-            if (index !== -1) {
-                tier.usageLimits.splice(index, 1);
-            }
+        if (!tier) {
+            throw new RemoveUsageLimitTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
+        }
+        const index = tier.usageLimits.findIndex((u) => u.id === action.input.limitId);
+        if (index !== -1) {
+            tier.usageLimits.splice(index, 1);
         }
         state.lastModified = action.input.lastModified;
     },
-    setTierPricingModeOperation(state, action) {
+    setTierDefaultBillingCycleOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            tier.pricingMode = action.input.pricingMode;
+        if (!tier) {
+            throw new SetTierDefaultBillingCycleTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        tier.defaultBillingCycle = action.input.defaultBillingCycle;
         state.lastModified = action.input.lastModified;
     },
-    setTierDefaultBillingCycleOperation(state, action) {
+    setTierBillingCycleDiscountsOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            tier.defaultBillingCycle = action.input.defaultBillingCycle;
+        if (!tier) {
+            throw new SetTierBillingCycleDiscountsTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        tier.billingCycleDiscounts = action.input.discounts.map((d) => ({
+            billingCycle: d.billingCycle,
+            discountRule: {
+                discountType: d.discountRule.discountType,
+                discountValue: d.discountRule.discountValue,
+            },
+        }));
         state.lastModified = action.input.lastModified;
     },
-    setTierBillingCycleDiscountsOperation(state, action) {
+    setTierPricingModeOperation(state, action) {
         const tier = state.tiers.find((t) => t.id === action.input.tierId);
-        if (tier) {
-            tier.billingCycleDiscounts = action.input.discounts.map((d) => ({
-                cycle: d.cycle,
-                discountType: d.discountType,
-                discountValue: d.discountValue,
-            }));
+        if (!tier) {
+            throw new SetTierPricingModeTierNotFoundError(`Tier with ID ${action.input.tierId} not found`);
         }
+        tier.pricingMode = action.input.pricingMode;
         state.lastModified = action.input.lastModified;
     },
 };

package/dist/document-models/service-offering/v1/src/utils.d.ts

@@ -1,2 +1,61 @@
-export {};
+import type { BillingCycle } from "../gen/schema/types.js";
+import type { ServiceOfferingPHState } from "../gen/types.js";
+export declare const BILLING_CYCLE_MONTHS: Record<BillingCycle, number>;
+export interface DiscountBreakdown {
+    discountType: string;
+    discountValue: number;
+    originalAmount: number;
+    discountedAmount: number;
+}
+export interface SetupCostDiscountBreakdown {
+    originalAmount: number;
+    discountedAmount: number;
+    discountType: string;
+    discountValue: number;
+}
+export interface OptionGroupBreakdown {
+    optionGroupId: string;
+    optionGroupName: string;
+    effectiveBillingCycle: BillingCycle;
+    monthlyBase: number;
+    cycleAmount: number;
+    recurringAmount: number;
+    currency: string;
+    discount: DiscountBreakdown | null;
+    setupCost: number | null;
+    setupCostCurrency: string | null;
+    setupCostDiscount: SetupCostDiscountBreakdown | null;
+}
+export interface AddOnBreakdown {
+    optionGroupId: string;
+    optionGroupName: string;
+    selectedBillingCycle: BillingCycle;
+    monthlyBase: number;
+    cycleAmount: number;
+    recurringAmount: number;
+    currency: string;
+    discount: DiscountBreakdown | null;
+    setupCost: number | null;
+    setupCostCurrency: string | null;
+}
+export interface PriceBreakdownTotals {
+    grandRecurringTotal: number;
+}
+export interface PriceBreakdown {
+    tierCycleTotal: number;
+    tierCurrency: string;
+    tierMonthlyBase: number;
+    optionGroupBreakdowns: OptionGroupBreakdown[];
+    setupGroupBreakdowns: OptionGroupBreakdown[];
+    addOnBreakdowns: AddOnBreakdown[];
+    totals: PriceBreakdownTotals;
+}
+export interface UserSelection {
+    tierId: string;
+    billingCycle: BillingCycle;
+    optionGroupIds: string[];
+    groupBillingCycleOverrides?: Record<string, BillingCycle>;
+    addonBillingCycleOverrides?: Record<string, BillingCycle>;
+}
+export declare function getUserSelectionPriceBreakdown(state: ServiceOfferingPHState, selection: UserSelection): PriceBreakdown;
 //# sourceMappingURL=utils.d.ts.map

package/dist/document-models/service-offering/v1/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../document-models/service-offering/v1/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../document-models/service-offering/v1/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM7D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,YAAY,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,YAAY,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,oBAAoB,EAAE,oBAAoB,EAAE,CAAC;IAC7C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1D,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC3D;AAyLD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,aAAa,GACvB,cAAc,CAmGhB"}

package/dist/document-models/service-offering/v1/src/utils.js

@@ -1 +1,173 @@
-export {};
+export const BILLING_CYCLE_MONTHS = {
+    MONTHLY: 1,
+    QUARTERLY: 3,
+    SEMI_ANNUAL: 6,
+    ANNUAL: 12,
+    ONE_TIME: 0,
+};
+function emptyBreakdown(currency) {
+    return {
+        tierCycleTotal: 0,
+        tierCurrency: currency,
+        tierMonthlyBase: 0,
+        optionGroupBreakdowns: [],
+        setupGroupBreakdowns: [],
+        addOnBreakdowns: [],
+        totals: { grandRecurringTotal: 0 },
+    };
+}
+function applyDiscount(amount, rule) {
+    let discountedAmount;
+    if (rule.discountType === "PERCENTAGE") {
+        discountedAmount = amount * (1 - rule.discountValue / 100);
+    }
+    else {
+        discountedAmount = amount - rule.discountValue;
+    }
+    discountedAmount = Math.max(0, Math.round(discountedAmount * 100) / 100);
+    return {
+        discountedAmount,
+        discount: {
+            discountType: rule.discountType,
+            discountValue: rule.discountValue,
+            originalAmount: amount,
+            discountedAmount,
+        },
+    };
+}
+function resolveGroupPricing(group, tier, effectiveCycle, globalCurrency) {
+    const months = BILLING_CYCLE_MONTHS[effectiveCycle];
+    // Get pricing source: tier-dependent first, then standalone
+    const tierPricing = group.tierDependentPricing?.find((tp) => tp.tierId === tier.id);
+    const pricing = tierPricing?.recurringPricing ||
+        group.standalonePricing?.recurringPricing ||
+        [];
+    // Monthly base
+    const monthlyOption = pricing.find((p) => p.billingCycle === "MONTHLY");
+    const monthlyBase = monthlyOption?.amount ?? 0;
+    // Price for effective cycle
+    const cycleOption = pricing.find((p) => p.billingCycle === effectiveCycle);
+    const cycleAmount = cycleOption?.amount ?? monthlyBase * (months || 1);
+    let discount = null;
+    let recurringAmount = cycleAmount;
+    // Check for discount on the cycle option itself
+    const optionDiscount = cycleOption?.discount;
+    if (optionDiscount && optionDiscount.discountValue > 0) {
+        const result = applyDiscount(cycleAmount, optionDiscount);
+        recurringAmount = result.discountedAmount;
+        discount = result.discount;
+    }
+    // If no direct discount, check tier billing cycle discounts for inherited groups
+    if (!discount && group.discountMode === "INHERIT_TIER") {
+        const tierDiscount = tier.billingCycleDiscounts.find((d) => d.billingCycle === effectiveCycle);
+        if (tierDiscount && tierDiscount.discountRule.discountValue > 0) {
+            const result = applyDiscount(cycleAmount, tierDiscount.discountRule);
+            recurringAmount = result.discountedAmount;
+            discount = result.discount;
+        }
+    }
+    // Setup cost
+    const setupCostSource = tierPricing?.setupCost || group.standalonePricing?.setupCost;
+    const setupCost = setupCostSource?.amount ?? null;
+    const setupCostCurrency = setupCostSource?.currency ?? null;
+    let setupCostDiscount = null;
+    if (setupCostSource?.discount && setupCostSource.discount.discountValue > 0) {
+        const original = setupCostSource.amount;
+        const rule = setupCostSource.discount;
+        let discounted;
+        if (rule.discountType === "PERCENTAGE") {
+            discounted = original * (1 - rule.discountValue / 100);
+        }
+        else {
+            discounted = original - rule.discountValue;
+        }
+        discounted = Math.max(0, Math.round(discounted * 100) / 100);
+        setupCostDiscount = {
+            originalAmount: original,
+            discountedAmount: discounted,
+            discountType: rule.discountType,
+            discountValue: rule.discountValue,
+        };
+    }
+    const priceCurrency = cycleOption?.currency || monthlyOption?.currency || globalCurrency;
+    return {
+        monthlyBase,
+        cycleAmount,
+        recurringAmount,
+        currency: priceCurrency,
+        discount,
+        setupCost,
+        setupCostCurrency,
+        setupCostDiscount,
+    };
+}
+function computeGroupBreakdown(group, tier, globalBillingCycle, globalCurrency, overrides) {
+    const effectiveCycle = overrides?.[group.id] || globalBillingCycle;
+    const pricing = resolveGroupPricing(group, tier, effectiveCycle, globalCurrency);
+    return {
+        optionGroupId: group.id,
+        optionGroupName: group.name,
+        effectiveBillingCycle: effectiveCycle,
+        ...pricing,
+    };
+}
+function computeAddOnBreakdown(group, tier, globalBillingCycle, globalCurrency, overrides) {
+    const selectedCycle = overrides?.[group.id] || globalBillingCycle;
+    const pricing = resolveGroupPricing(group, tier, selectedCycle, globalCurrency);
+    return {
+        optionGroupId: group.id,
+        optionGroupName: group.name,
+        selectedBillingCycle: selectedCycle,
+        monthlyBase: pricing.monthlyBase,
+        cycleAmount: pricing.cycleAmount,
+        recurringAmount: pricing.recurringAmount,
+        currency: pricing.currency,
+        discount: pricing.discount,
+        setupCost: pricing.setupCost,
+        setupCostCurrency: pricing.setupCostCurrency,
+    };
+}
+export function getUserSelectionPriceBreakdown(state, selection) {
+    const { tierId, billingCycle, optionGroupIds, groupBillingCycleOverrides, addonBillingCycleOverrides, } = selection;
+    const globalState = state.global;
+    const tier = globalState.tiers.find((t) => t.id === tierId);
+    if (!tier) {
+        return emptyBreakdown("USD");
+    }
+    const currency = tier.pricing.currency || "USD";
+    const months = BILLING_CYCLE_MONTHS[billingCycle];
+    // Tier cycle total from tier pricing
+    const tierMonthlyAmount = tier.pricing.amount ?? 0;
+    const tierCycleTotal = tierMonthlyAmount * (months || 1);
+    // Sum of monthly base prices across all regular (non-setup, non-addon) option groups
+    const regularGroups = globalState.optionGroups.filter((g) => g.costType !== "SETUP" && !g.isAddOn);
+    const tierMonthlyBase = regularGroups.reduce((sum, group) => {
+        const tierPricing = group.tierDependentPricing?.find((tp) => tp.tierId === tierId);
+        const pricing = tierPricing?.recurringPricing ||
+            group.standalonePricing?.recurringPricing ||
+            [];
+        const monthlyOption = pricing.find((p) => p.billingCycle === "MONTHLY");
+        return sum + (monthlyOption?.amount ?? 0);
+    }, 0);
+    // Separate option groups by type
+    const setupGroups = globalState.optionGroups.filter((g) => g.costType === "SETUP");
+    const addonGroups = globalState.optionGroups.filter((g) => g.isAddOn && optionGroupIds.includes(g.id));
+    const optionGroupBreakdowns = regularGroups.map((group) => computeGroupBreakdown(group, tier, billingCycle, currency, groupBillingCycleOverrides));
+    const setupGroupBreakdowns = setupGroups.map((group) => computeGroupBreakdown(group, tier, billingCycle, currency, groupBillingCycleOverrides));
+    const addOnBreakdowns = addonGroups.map((group) => computeAddOnBreakdown(group, tier, billingCycle, currency, addonBillingCycleOverrides));
+    // Grand recurring total
+    const optionGroupRecurring = optionGroupBreakdowns.reduce((sum, b) => sum + b.recurringAmount, 0);
+    const addOnRecurring = addOnBreakdowns.reduce((sum, b) => sum + b.recurringAmount, 0);
+    const grandRecurringTotal = tierCycleTotal + optionGroupRecurring + addOnRecurring;
+    return {
+        tierCycleTotal,
+        tierCurrency: currency,
+        tierMonthlyBase,
+        optionGroupBreakdowns,
+        setupGroupBreakdowns,
+        addOnBreakdowns,
+        totals: {
+            grandRecurringTotal,
+        },
+    };
+}

package/dist/document-models/service-offering/v1/tests/option-groups.test.js

@@ -1,6 +1,6 @@
 import { generateMock } from "@powerhousedao/common/utils";
 import { describe, expect, it } from "vitest";
-import { reducer, utils, isServiceOfferingDocument, addOptionGroup, updateOptionGroup, deleteOptionGroup, setOptionGroupStandalonePricing, addOptionGroupTierPricing, updateOptionGroupTierPricing, removeOptionGroupTierPricing, setOptionGroupDiscountMode, AddOptionGroupInputSchema, UpdateOptionGroupInputSchema, DeleteOptionGroupInputSchema, SetOptionGroupStandalonePricingInputSchema, AddOptionGroupTierPricingInputSchema, UpdateOptionGroupTierPricingInputSchema, RemoveOptionGroupTierPricingInputSchema, SetOptionGroupDiscountModeInputSchema, } from "@powerhousedao/service-offering/document-models/service-offering/v1";
+import { reducer, utils, isServiceOfferingDocument, addOptionGroup, updateOptionGroup, deleteOptionGroup, setOptionGroupStandalonePricing, AddOptionGroupInputSchema, UpdateOptionGroupInputSchema, DeleteOptionGroupInputSchema, SetOptionGroupStandalonePricingInputSchema, addOptionGroupTierPricing, updateOptionGroupTierPricing, removeOptionGroupTierPricing, setOptionGroupDiscountMode, AddOptionGroupTierPricingInputSchema, UpdateOptionGroupTierPricingInputSchema, RemoveOptionGroupTierPricingInputSchema, SetOptionGroupDiscountModeInputSchema, } from "@powerhousedao/service-offering/document-models/service-offering/v1";
 describe("OptionGroupsOperations", () => {
     it("should handle addOptionGroup operation", () => {
         const document = utils.createDocument();

package/dist/document-models/service-offering/v1/utils.d.ts

@@ -1,6 +1,9 @@
 import type { ServiceOfferingPHState } from "./gen/types.js";
+import * as customUtils from "./src/utils.js";
 /** Utils for the ServiceOffering document model */
 export declare const utils: {
+    getUserSelectionPriceBreakdown(state: ServiceOfferingPHState, selection: customUtils.UserSelection): customUtils.PriceBreakdown;
+    BILLING_CYCLE_MONTHS: Record<import("./gen/types.js").BillingCycle, number>;
     fileExtension: string;
     createState: import("document-model").CreateState<ServiceOfferingPHState>;
     createDocument: import("document-model").CreateDocument<ServiceOfferingPHState>;

package/dist/document-models/service-offering/v1/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../document-models/service-offering/v1/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAI7D,mDAAmD;AACnD,eAAO,MAAM,KAAK;;;;;;;;;;CAGoC,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../document-models/service-offering/v1/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAE9C,mDAAmD;AACnD,eAAO,MAAM,KAAK;;;;;;;;;;;;CAGoC,CAAC"}

package/dist/document-models/subscription-instance/v1/actions.d.ts

@@ -39,7 +39,9 @@ export declare const actions: {
     setAutoRenew: (input: import("./index.js").SetAutoRenewInput) => import("./index.js").SetAutoRenewAction;
     setRenewalDate: (input: import("./index.js").SetRenewalDateInput) => import("./index.js").SetRenewalDateAction;
     updateBillingProjection: (input: import("./index.js").UpdateBillingProjectionInput) => import("./index.js").UpdateBillingProjectionAction;
-    setName: (name: string) => import("document-model").SetNameAction;
+    setName: (name: string | {
+        name: string;
+    }) => import("document-model").SetNameAction;
     undo: (count?: number, scope?: string) => import("document-model").UndoAction;
     redo: (count?: number, scope?: string) => import("document-model").RedoAction;
     prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;

package/dist/document-models/subscription-instance/v1/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../document-models/subscription-instance/v1/actions.ts"],"names":[],"mappings":"AASA,0DAA0D;AAE1D,eAAO,MAAM,OAAO;sBAKX,gDACM;4BAEuK,sDAAiC;uBAAyF,iDAA4B;mBAA0L,6CAAwB;wBAAkL,kDAA6B;0BAAoM,oDAA+B;2BAA2M,qDAAgC;2BAA8M,qDAAgC;sBAA1rC,gDAA2B;yBAA6L,mDAA8B;wBAAqM,kDAA6B;6BAAwM,uDAAkC;6BAAuN,uDAAkC;iBAAzjB,2CAAsB;oBAAwK,8CAAyB;6BAA0L,uDAAkC;iCAA2N,2DAAyC;yBAAiO,mDAA8B;6BAA0M,uDAAkC;wBAAiN,kDAA6B;+BAAyM,yDAAuC;kCAAoO,4DAA0C;6BAA/uC,uDAAkC;0BAAkN,oDAA+B;+BAA+M,yDAAuC;2BAA4N,qDAAgC;wBAA0M,kDAA6B;kBAA2L,4CAAuB;yBAAgL,mDAA8B;yBAAqM,mDAA8B;gCAA4M,0DAAwC;wBAA4N,kDAA6B;2BAAqM,qDAAgC;yBAA4M,mDAA8B;qBAAkM,+CAA0B;uBAAwL,iDAA4B;mBAA0L,6CAAwB;qBAAgL,+CAA0B;8BAA+L,wDAAmC;;gBAAg4D,CAAC,eAAe,CAAC;gBAAkE,CAAC,eAAe,CAAC;iBAAmE,CAAC,aAAa,CAAC,eAAe,CAAC;;;;gBAAqS,CAAC;CADptO,CAAC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../document-models/subscription-instance/v1/actions.ts"],"names":[],"mappings":"AASA,0DAA0D;AAE1D,eAAO,MAAM,OAAO;sBAKX,gDACM;4BAEuK,sDAAiC;uBAAyF,iDAA4B;mBAA0L,6CAAwB;wBAAkL,kDAA6B;0BAAoM,oDAA+B;2BAA2M,qDAAgC;2BAA8M,qDAAgC;sBAA1rC,gDAA2B;yBAA6L,mDAA8B;wBAAqM,kDAA6B;6BAAwM,uDAAkC;6BAAuN,uDAAkC;iBAAzjB,2CAAsB;oBAAwK,8CAAyB;6BAA0L,uDAAkC;iCAA2N,2DAAyC;yBAAiO,mDAA8B;6BAA0M,uDAAkC;wBAAiN,kDAA6B;+BAAyM,yDAAuC;kCAAoO,4DAA0C;6BAA/uC,uDAAkC;0BAAkN,oDAA+B;+BAA+M,yDAAuC;2BAA4N,qDAAgC;wBAA0M,kDAA6B;kBAA2L,4CAAuB;yBAAgL,mDAA8B;yBAAqM,mDAA8B;gCAA4M,0DAAwC;wBAA4N,kDAA6B;2BAAqM,qDAAgC;yBAA4M,mDAA8B;qBAAkM,+CAA0B;uBAAwL,iDAA4B;mBAA0L,6CAAwB;qBAAgL,+CAA0B;8BAA+L,wDAAmC;;;;gBAAw7D,CAAC,eAAe,CAAC;gBAAkE,CAAC,eAAe,CAAC;iBAAmE,CAAC,aAAa,CAAC,eAAe,CAAC;;;;gBAAqS,CAAC;CAD5wO,CAAC"}

package/dist/document-models/subscription-instance/v1/gen/controller.d.ts

@@ -0,0 +1,4 @@
+import { PHDocumentController } from "document-model/core";
+import type { SubscriptionInstanceAction, SubscriptionInstancePHState } from "./types.js";
+export declare const SubscriptionInstanceController: new (initialDocument?: import("document-model").PHDocument<SubscriptionInstancePHState> | undefined) => PHDocumentController<SubscriptionInstancePHState> & import("document-model/core").ActionMap<SubscriptionInstanceAction, PHDocumentController<SubscriptionInstancePHState>>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/document-models/subscription-instance/v1/gen/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../document-models/subscription-instance/v1/gen/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,8BAA8B,oRAIlB,CAAC"}

package/dist/document-models/subscription-instance/v1/gen/controller.js

@@ -0,0 +1,3 @@
+import { PHDocumentController } from "document-model/core";
+import { SubscriptionInstance } from "../module.js";
+export const SubscriptionInstanceController = PHDocumentController.forDocumentModel(SubscriptionInstance);

package/dist/document-models/subscription-instance/v1/gen/document-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-model.d.ts","sourceRoot":"","sources":["../../../../../document-models/subscription-instance/v1/gen/document-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,wBAkjB3B,CAAC"}
+{"version":3,"file":"document-model.d.ts","sourceRoot":"","sources":["../../../../../document-models/subscription-instance/v1/gen/document-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,wBA6yB3B,CAAC"}