@zuplo/zudoku-plugin-monetization 0.0.41 → 0.0.42

package/dist/{PricingTable-DNop2iX9.mjs → PricingTable-BlcXx4-5.mjs}

@@ -1,6 +1,6 @@
 import { Fragment } from "react";
-import { parse } from "tinyduration";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { parse } from "tinyduration";
 import { clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
 //#region src/utils/formatDuration.ts
@@ -136,6 +136,17 @@ const formatTieredPriceBreakdown = (opts) => {
 	return lines.length > 0 ? lines : void 0;
 };
 //#endregion
+//#region src/utils/tierHasPositivePrice.ts
+/**
+* Whether a price tier charges anything — a non-zero flat or per-unit amount.
+* Amounts are decimal strings and a missing part counts as zero, so this
+* distinguishes a genuinely priced tier from an all-zero ("Included") tier.
+* Shared by the pricing-label path ({@link formatPlanPrice}) and rate-card
+* categorization ({@link categorizeRateCards}) so both decide "is this tier
+* free?" the same way.
+*/
+const tierHasPositivePrice = (tier) => parseFloat(tier.flatPrice?.amount ?? "0") > 0 || parseFloat(tier.unitPrice?.amount ?? "0") > 0;
+//#endregion
 //#region src/utils/categorizeRateCards.ts
 const categorizeRateCards = (rateCards, options) => {
 	const { currency, units, planBillingCadence } = options ?? {};
@@ -152,7 +163,7 @@ const categorizeRateCards = (rateCards, options) => {
 			return "month";
 		};
 		const firstTier = rc.price?.type === "tiered" && rc.price.tiers.length > 0 ? rc.price.tiers[0] : void 0;
-		const firstTierIsPriced = !!firstTier && (parseFloat(firstTier.flatPrice?.amount ?? "0") > 0 || parseFloat(firstTier.unitPrice?.amount ?? "0") > 0);
+		const firstTierIsPriced = !!firstTier && tierHasPositivePrice(firstTier);
 		if (et.type === "metered" && et.issueAfterReset != null && !firstTierIsPriced) {
 			let tierPrices;
 			if (rc.price?.type === "tiered" && rc.price.tiers) tierPrices = formatTieredPriceBreakdown({
@@ -176,7 +187,7 @@ const categorizeRateCards = (rateCards, options) => {
 			const unitLabel = unitLabelFor(rc);
 			if (rc.price.type === "tiered" && rc.price.tiers.length > 0) {
 				const tiers = rc.price.tiers;
-				if (!tiers.some((t) => parseFloat(t.flatPrice?.amount ?? "0") > 0 || parseFloat(t.unitPrice?.amount ?? "0") > 0)) {
+				if (!tiers.some(tierHasPositivePrice)) {
 					features.push({
 						key: rc.featureKey ?? rc.key,
 						name: rc.name
@@ -331,28 +342,23 @@ const QuotaItem = ({ quota, className }) => {
 	});
 };
 //#endregion
-//#region src/pricing-ui/PlanEntitlements.tsx
-const PhaseSection = ({ phase, currency, showName, billingCadence, units, itemClassName }) => {
-	const { quotas, features } = categorizeRateCards(phase.rateCards, {
-		currency,
-		units,
-		planBillingCadence: billingCadence
-	});
+//#region src/pricing-ui/EntitlementList.tsx
+/**
+* Vertical list of a resolved entitlement set — quotas first, then features —
+* with an optional leading `header` (e.g. a phase name) rendered inside the same
+* spacing container. Returns `null` when there are no quotas or features, so
+* callers can gate a section header / border without leaving an empty container
+* behind.
+*
+* Shared by {@link PlanEntitlements} (one list per phase) and the subscription
+* entitlement views so quotas and features always render identically.
+*/
+const EntitlementList = ({ quotas, features, header, itemClassName }) => {
 	if (quotas.length === 0 && features.length === 0) return null;
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-2",
 		children: [
-			showName && /* @__PURE__ */ jsxs("div", {
-				className: "text-sm font-medium text-card-foreground",
-				children: [phase.name, phase.duration && /* @__PURE__ */ jsxs("span", {
-					className: "text-muted-foreground font-normal",
-					children: [
-						" ",
-						"— ",
-						formatDuration(phase.duration)
-					]
-				})]
-			}),
+			header,
 			quotas.map((quota) => /* @__PURE__ */ jsx(QuotaItem, {
 				quota,
 				className: itemClassName
@@ -364,6 +370,31 @@ const PhaseSection = ({ phase, currency, showName, billingCadence, units, itemCl
 		]
 	});
 };
+//#endregion
+//#region src/pricing-ui/PlanEntitlements.tsx
+const PhaseSection = ({ phase, currency, showName, billingCadence, units, itemClassName }) => {
+	const { quotas, features } = categorizeRateCards(phase.rateCards, {
+		currency,
+		units,
+		planBillingCadence: billingCadence
+	});
+	return /* @__PURE__ */ jsx(EntitlementList, {
+		quotas,
+		features,
+		itemClassName,
+		header: showName ? /* @__PURE__ */ jsxs("div", {
+			className: "text-sm font-medium text-card-foreground",
+			children: [phase.name, phase.duration && /* @__PURE__ */ jsxs("span", {
+				className: "text-muted-foreground font-normal",
+				children: [
+					" ",
+					"— ",
+					formatDuration(phase.duration)
+				]
+			})]
+		}) : void 0
+	});
+};
 const PlanEntitlements = ({ phases, currency, billingCadence, units, itemClassName }) => {
 	return /* @__PURE__ */ jsx("div", {
 		className: "space-y-4",
@@ -378,87 +409,100 @@ const PlanEntitlements = ({ phases, currency, billingCadence, units, itemClassNa
 	});
 };
 //#endregion
-//#region src/utils/getPriceFromPlan.ts
+//#region src/pricing-ui/PlanPriceTag.tsx
+/**
+* Headline price for a plan/subscription: `$X/cadence`, "Pay as you go", or
+* "Free", from a {@link PlanPriceLabel}. Shared by the subscription details
+* page, the Switch Plan baseline, each plan-change card, and the checkout /
+* plan-change summary cards so they all render the price identically.
+*
+* `size` selects the typographic treatment:
+*   - `"inline"` (default): compact, primary-colored text for use beside a name.
+*   - `"lg"`: a large foreground headline for a summary card's price column.
+*
+* Pass `description` to surface the "Usage-based pricing" subline under the
+* "Pay as you go" headline (used where there's room for it).
+*/
+const PlanPriceTag = ({ label, currency, billingCadence, description = false, size = "inline" }) => {
+	const isLg = size === "lg";
+	if (label.type === "priced") return /* @__PURE__ */ jsxs("span", {
+		className: isLg ? "text-2xl font-bold" : "text-primary font-medium text-lg",
+		children: [formatPrice(label.amount, currency), billingCadence && /* @__PURE__ */ jsxs("span", {
+			className: "text-muted-foreground font-normal",
+			children: ["/", formatDuration(billingCadence)]
+		})]
+	});
+	if (label.type === "payg") return /* @__PURE__ */ jsxs("span", {
+		className: isLg ? "text-2xl font-bold text-balance" : "text-primary font-medium",
+		children: [label.main, description && /* @__PURE__ */ jsx("span", {
+			className: isLg ? "block text-sm text-muted-foreground font-normal mt-1" : "block text-xs text-muted-foreground font-normal",
+			children: label.sub
+		})]
+	});
+	return /* @__PURE__ */ jsx("span", {
+		className: isLg ? "text-2xl text-muted-foreground font-bold" : "text-primary font-medium",
+		children: "Free"
+	});
+};
+//#endregion
+//#region src/utils/getPlanPrice.ts
 const sumFlatFeeAmounts = (rateCards) => {
 	let total = 0;
-	for (const rc of rateCards) if (rc.type === "flat_fee" && rc.price) {
+	for (const rc of rateCards) if (rc.type === "flat_fee" && rc.price && rc.billingCadence !== null) {
 		const amount = Number(rc.price.amount);
 		if (Number.isFinite(amount)) total += amount;
 	}
 	return total;
 };
 /**
-* Convert an ISO 8601 duration to an approximate number of months.
-* Years and months contribute exactly; weeks use 12/52 months/week and
-* days use 1/30 months/day. Sub-day units (hours, minutes, seconds) do
-* not contribute and a duration consisting only of those returns
-* `undefined` because there is no sensible monthly equivalent.
-*/
-const cadenceToMonths = (iso) => {
-	try {
-		const d = parse(iso);
-		let months = 0;
-		if (d.years) months += d.years * 12;
-		if (d.months) months += d.months;
-		if (d.weeks) months += d.weeks * (12 / 52);
-		if (d.days) months += d.days * (1 / 30);
-		return months > 0 ? months : void 0;
-	} catch {
-		return;
-	}
-};
-/**
-* Derive a (monthly, yearly) headline price from a plan's last phase by
-* summing all `flat_fee` rate-card amounts and converting from the plan's
-* `billingCadence` to a monthly equivalent.
+* The plan's headline recurring price: the sum of every recurring `flat_fee`
+* rate-card amount on the plan's steady-state (last) phase, expressed in the
+* plan's own `billingCadence`. One-time fees (`flat_fee` with
+* `billingCadence: null`, e.g. a setup fee) are excluded.
 *
-* Returns `null` for either field when no value can be derived (no
-* phases, or an unparseable / sub-day cadence). A flat-fee sum of 0
-* returns `{ monthly: 0, yearly: 0 }` (Free).
+* This is derived entirely from the plan's rate cards. It deliberately does
+* NOT read any server-provided `monthlyPrice` / `yearlyPrice` and performs no
+* cadence conversion, so it stays correct for any billing cadence — hourly
+* (`PT1H`), weekly, monthly, yearly, etc. Callers pair the returned amount
+* with `formatDuration(plan.billingCadence)` to render e.g. `$2.99/hour`.
 *
-* Useful for consumers whose source data doesn't already include
-* pre-computed `monthlyPrice` / `yearlyPrice` — pass the result through
-* (or rely on `getPriceFromPlan`'s built-in fallback).
+* Returns `0` when there are no phases or no recurring flat fee, which callers
+* render as "Free" (or "Pay as you go" when the plan bills on usage — see
+* {@link formatPlanPrice}).
 */
-const derivePriceFromPlan = (plan) => {
+const getPlanPrice = (plan) => {
 	const lastPhase = plan.phases?.at(-1);
-	if (!lastPhase) return {
-		monthly: null,
-		yearly: null
-	};
-	const flatPrice = sumFlatFeeAmounts(lastPhase.rateCards ?? []);
-	if (flatPrice === 0) return {
-		monthly: 0,
-		yearly: 0
-	};
-	const months = cadenceToMonths(plan.billingCadence);
-	if (months == null) return {
-		monthly: null,
-		yearly: null
-	};
-	const monthly = flatPrice / months;
-	return {
-		monthly,
-		yearly: monthly * 12
-	};
+	if (!lastPhase) return 0;
+	return sumFlatFeeAmounts(lastPhase.rateCards ?? []);
+};
+//#endregion
+//#region src/utils/formatPlanPrice.ts
+const isPricedUsageRateCard = (rc) => {
+	if (rc.type !== "usage_based" || !rc.price) return false;
+	const p = rc.price;
+	if (p.type === "unit") return parseFloat(p.amount) > 0;
+	if (p.type === "tiered") return p.tiers.some(tierHasPositivePrice);
+	return true;
 };
+const hasPricedUsageRateCard = (plan) => plan.phases.some((phase) => phase.rateCards.some(isPricedUsageRateCard));
 /**
-* Returns the monthly and yearly headline price for a plan. Prefers the
-* server-provided `monthlyPrice` / `yearlyPrice` strings when present;
-* otherwise falls back to {@link derivePriceFromPlan}. Values that can't
-* be resolved are reported as `0`, which the pricing card renders as
-* "Free".
+* Headline pricing for plan cards. Centralizes the "Pay as you go" detection:
+* plans whose flat-fee total is zero but that bill on usage shouldn't render
+* as "Free" - they're charged per-unit.
 */
-const getPriceFromPlan = (plan) => {
-	if (plan.monthlyPrice != null || plan.yearlyPrice != null) return {
-		monthly: plan.monthlyPrice != null ? parseFloat(plan.monthlyPrice) : 0,
-		yearly: plan.yearlyPrice != null ? parseFloat(plan.yearlyPrice) : 0
+const formatPlanPrice = (plan) => {
+	if (!plan.phases || plan.phases.length === 0) return { type: "free" };
+	const amount = getPlanPrice(plan);
+	if (amount > 0) return {
+		type: "priced",
+		amount
 	};
-	const derived = derivePriceFromPlan(plan);
-	return {
-		monthly: derived.monthly ?? 0,
-		yearly: derived.yearly ?? 0
+	if (hasPricedUsageRateCard(plan)) return {
+		type: "payg",
+		main: "Pay as you go",
+		sub: "Usage-based pricing"
 	};
+	return { type: "free" };
 };
 //#endregion
 //#region src/utils/pricingTaxLegend.ts
@@ -494,41 +538,24 @@ const subscriptionTaxLegendSentence = (behavior) => {
 	}
 };
 //#endregion
-//#region src/utils/formatPlanPrice.ts
-const isPricedUsageRateCard = (rc) => {
-	if (rc.type !== "usage_based" || !rc.price) return false;
-	const p = rc.price;
-	if (p.type === "unit") return parseFloat(p.amount) > 0;
-	if (p.type === "tiered") return p.tiers.some((t) => parseFloat(t.flatPrice?.amount ?? "0") > 0 || parseFloat(t.unitPrice?.amount ?? "0") > 0);
-	return true;
-};
-const hasPricedUsageRateCard = (plan) => plan.phases.some((phase) => phase.rateCards.some(isPricedUsageRateCard));
+//#region src/utils/isCustomPlan.ts
 /**
-* Headline pricing for plan cards. Centralizes the "Pay as you go" detection:
-* plans whose flat-fee total is zero but that bill on usage shouldn't render
-* as "Free" - they're charged per-unit.
+* A plan is "custom" (contact-sales, no self-serve price) when its metadata
+* flags it. Mirrors the convention used by the pricing card
+* (`PricingCard.tsx`), accepting boolean `true` or the string `"true"` — plan
+* metadata values arrive as strings from the API but may be set as booleans in
+* code/fixtures.
 */
-const formatPlanPrice = (plan) => {
-	if (plan.phases.length === 0) return { type: "free" };
-	const { monthly, yearly } = getPriceFromPlan(plan);
-	if (monthly > 0) return {
-		type: "priced",
-		monthly,
-		yearly
-	};
-	if (hasPricedUsageRateCard(plan)) return {
-		type: "payg",
-		main: "Pay as you go",
-		sub: "Usage-based pricing"
-	};
-	return { type: "free" };
+const isCustomPlan = (plan) => {
+	const flag = plan.metadata?.isCustom;
+	return flag === true || flag === "true";
 };
 //#endregion
 //#region src/pricing-ui/PricingCard.tsx
-const PricingCard = ({ plan, isPopular = false, showYearlyPrice = true, units, action, className }) => {
+const PricingCard = ({ plan, isPopular = false, units, action, className }) => {
 	if (plan.phases.length === 0) return null;
 	const priceLabel = formatPlanPrice(plan);
-	const isCustom = plan.metadata?.isCustom === true;
+	const isCustom = isCustomPlan(plan);
 	const billingInterval = formatDuration(plan.billingCadence);
 	return /* @__PURE__ */ jsxs("div", {
 		className: cn("relative rounded-lg border p-6 flex flex-col", isPopular && "border-primary border-2", className),
@@ -564,20 +591,13 @@ const PricingCard = ({ plan, isPopular = false, showYearlyPrice = true, units, a
 						})] }) : priceLabel.type === "free" ? /* @__PURE__ */ jsx("span", {
 							className: "text-3xl font-bold text-card-foreground",
 							children: "Free"
-						}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [
-							/* @__PURE__ */ jsx("span", {
-								className: "text-3xl font-bold text-card-foreground",
-								children: formatPrice(priceLabel.monthly, plan.currency)
-							}),
-							/* @__PURE__ */ jsxs("span", {
-								className: "text-muted-foreground text-sm",
-								children: ["/", billingInterval]
-							}),
-							showYearlyPrice && priceLabel.yearly > 0 && /* @__PURE__ */ jsxs("div", {
-								className: "w-full text-sm text-muted-foreground mt-1",
-								children: [formatPrice(priceLabel.yearly, plan.currency), "/year"]
-							})
-						] })
+						}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+							className: "text-3xl font-bold text-card-foreground",
+							children: formatPrice(priceLabel.amount, plan.currency)
+						}), /* @__PURE__ */ jsxs("span", {
+							className: "text-muted-foreground text-sm",
+							children: ["/", billingInterval]
+						})] })
 					}),
 					plan.paymentRequired === false && /* @__PURE__ */ jsx("div", {
 						className: "text-sm text-muted-foreground mt-1",
@@ -607,7 +627,7 @@ const DefaultEmptyState = () => /* @__PURE__ */ jsxs("div", {
 		children: "Make sure your plans are set up and published."
 	})]
 });
-const PricingTable = ({ plans, showYearlyPrice = true, units, renderAction, renderCard, isPopular = (plan) => plan.metadata?.zuplo_most_popular === "true", emptyState, showTaxLegend = true, className, cardClassName }) => {
+const PricingTable = ({ plans, units, renderAction, renderCard, isPopular = (plan) => plan.metadata?.zuplo_most_popular === "true", emptyState, showTaxLegend = true, className, cardClassName }) => {
 	if (plans.length === 0) return /* @__PURE__ */ jsx(Fragment$1, { children: emptyState ?? /* @__PURE__ */ jsx(DefaultEmptyState, {}) });
 	const firstPlan = plans[0];
 	const taxLegendSentence = showTaxLegend && firstPlan ? taxBehaviorLegendSentence(collectDefaultTaxBehaviors(firstPlan)) : void 0;
@@ -618,7 +638,6 @@ const PricingTable = ({ plans, showYearlyPrice = true, units, renderAction, rend
 			const defaultCard = /* @__PURE__ */ jsx(PricingCard, {
 				plan,
 				isPopular: popular,
-				showYearlyPrice,
 				units,
 				action: renderAction?.(plan, popular),
 				className: cardClassName
@@ -641,4 +660,4 @@ const PricingTable = ({ plans, showYearlyPrice = true, units, renderAction, rend
 	})] });
 };
 //#endregion
-export { formatDuration as _, subscriptionTaxLegendSentence as a, getPriceFromPlan as c, FeatureItem as d, categorizeRateCards as f, formatPrice as g, formatMinorCurrencyAmount as h, planHasDefaultTaxBehavior as i, PlanEntitlements as l, formatStaticEntitlementConfig as m, PricingCard as n, taxBehaviorLegendSentence as o, formatTieredPriceBreakdown as p, collectDefaultTaxBehaviors as r, derivePriceFromPlan as s, PricingTable as t, QuotaItem as u, formatDurationAdjective as v, formatDurationInterval as y };
+export { formatDurationInterval as S, formatStaticEntitlementConfig as _, planHasDefaultTaxBehavior as a, formatDuration as b, formatPlanPrice as c, PlanEntitlements as d, EntitlementList as f, formatTieredPriceBreakdown as g, categorizeRateCards as h, collectDefaultTaxBehaviors as i, getPlanPrice as l, FeatureItem as m, PricingCard as n, subscriptionTaxLegendSentence as o, QuotaItem as p, isCustomPlan as r, taxBehaviorLegendSentence as s, PricingTable as t, PlanPriceTag as u, formatMinorCurrencyAmount as v, formatDurationAdjective as x, formatPrice as y };

package/dist/index.d.mts

@@ -3,7 +3,6 @@ interface MonetizationConfig {
   pricing?: {
     subtitle?: string;
     title?: string;
-    showYearlyPrice?: boolean;
     units?: Record<string, string>;
   };
 }