@nextblock-cms/ecom 0.22.2 → 0.22.3

package/lib/freemius-order-sync.es.js

@@ -1,34 +1,36 @@
 import { parseFreemiusCheckoutCredentialsMap as e, readFreemiusEnvValue as t, resolveFreemiusCheckoutCredentials as n } from "./providers/freemius.es.js";
 import { applyOrderInventoryDeduction as r } from "./order-inventory.es.js";
 import { assignInvoiceMetadata as i } from "./invoice-server.es.js";
-import { createClient as a } from "@supabase/supabase-js";
-import o from "crypto";
-import { Freemius as s } from "@freemius/sdk";
+import { evaluateFreemiusLicenseClaim as a, parseFreemiusTimestamp as o, retrieveFreemiusLicenseRecords as s } from "./freemius-license-claim.es.js";
+import "server-only";
+import { createClient as c } from "@supabase/supabase-js";
+import l from "crypto";
+import { Freemius as u } from "@freemius/sdk";
 //#region src/lib/freemius-order-sync.ts
-function c(e) {
+function d(e) {
 	return e == null || e === "" ? null : String(e);
 }
-function l(e) {
-	let t = c(e);
+function f(e) {
+	let t = d(e);
 	if (!t) return null;
 	let n = t.includes("T") ? t : t.replace(" ", "T") + "Z", r = new Date(n);
 	return Number.isNaN(r.getTime()) ? t : r.toISOString();
 }
-function u(e) {
+function p(e) {
 	if (e == null || e === "") return null;
 	let t = Number(e);
 	return Number.isFinite(t) ? t : null;
 }
-function d(...e) {
+function m(...e) {
 	return e.some((e) => {
-		let t = u(e);
+		let t = p(e);
 		return t !== null && t > 0;
 	});
 }
-function f(e) {
+function h(e) {
 	return e === "pending" || e === "trial";
 }
-function p(e) {
+function g(e) {
 	return [
 		"license.cancelled",
 		"license.deleted",
@@ -39,38 +41,38 @@ function p(e) {
 		"trial.expired"
 	].includes(e || "");
 }
-function m(e, t) {
+function _(e, t) {
 	return e === "license.extended" && (t?.is_renewal === !0 || t?.is_renewal === 1 || t?.is_renewal === "1" || t?.is_renewal === "true");
 }
-function h(e) {
+function v(e) {
 	let t = e.objects?.payment ?? e.data?.payment ?? e.data;
-	return e.type === "payment.created" && d(t?.gross, t?.total_gross, t?.amount, t?.initial_amount);
+	return e.type === "payment.created" && m(t?.gross, t?.total_gross, t?.amount, t?.initial_amount);
 }
-function g(e) {
+function y(e) {
 	let t = e?.purchase ?? null, n = e?.trial ?? null;
 	return {
-		freemius_product_id: c(t?.plugin_id) ?? c(t?.product_id) ?? c(t?.productId) ?? c(n?.plugin_id) ?? c(n?.product_id) ?? c(n?.productId),
-		freemius_plan_id: c(t?.plan_id) ?? c(t?.planId),
-		freemius_license_id: c(t?.license_id) ?? c(t?.licenseId) ?? c(n?.license_id) ?? c(n?.licenseId),
-		freemius_subscription_id: c(t?.subscription_id) ?? c(t?.subscriptionId) ?? c(n?.subscription_id) ?? c(n?.subscriptionId),
-		freemius_trial_id: c(n?.id),
-		freemius_user_id: c(t?.user_id) ?? c(t?.userId) ?? c(n?.user_id) ?? c(n?.userId) ?? c(e?.user?.id),
-		freemius_trial_ends_at: l(n?.trial_ends_at) ?? l(n?.trialEndsAt) ?? l(t?.trial_ends) ?? l(t?.trialEnds)
+		freemius_product_id: d(t?.plugin_id) ?? d(t?.product_id) ?? d(t?.productId) ?? d(n?.plugin_id) ?? d(n?.product_id) ?? d(n?.productId),
+		freemius_plan_id: d(t?.plan_id) ?? d(t?.planId),
+		freemius_license_id: d(t?.license_id) ?? d(t?.licenseId) ?? d(n?.license_id) ?? d(n?.licenseId),
+		freemius_subscription_id: d(t?.subscription_id) ?? d(t?.subscriptionId) ?? d(n?.subscription_id) ?? d(n?.subscriptionId),
+		freemius_trial_id: d(n?.id),
+		freemius_user_id: d(t?.user_id) ?? d(t?.userId) ?? d(n?.user_id) ?? d(n?.userId) ?? d(e?.user?.id),
+		freemius_trial_ends_at: f(n?.trial_ends_at) ?? f(n?.trialEndsAt) ?? f(t?.trial_ends) ?? f(t?.trialEnds)
 	};
 }
-function _(e, t = "pending") {
+function b(e, t = "pending") {
 	let n = e?.purchase ?? null, r = e?.trial ?? null;
-	return t === "paid" ? "paid" : r && (r.canceled_at || r.canceledAt) && f(t) ? "cancelled" : r ? "trial" : n ? (n.canceled_at || n.canceledAt) && f(t) ? "cancelled" : d(n.initial_amount, n.initialAmount, n.gross, n.total_gross, n.totalGross) ? "paid" : n.trial_ends || n.trialEnds || n.subscription_id || n.subscriptionId ? "trial" : t : t;
+	return t === "paid" ? "paid" : r && (r.canceled_at || r.canceledAt) && h(t) ? "cancelled" : r ? "trial" : n ? (n.canceled_at || n.canceledAt) && h(t) ? "cancelled" : m(n.initial_amount, n.initialAmount, n.gross, n.total_gross, n.totalGross) ? "paid" : n.trial_ends || n.trialEnds || n.subscription_id || n.subscriptionId ? "trial" : t : t;
 }
-function v(e) {
+function x(e) {
 	let { event: t, currentStatus: n, purchaseData: r } = e;
-	return n === "paid" && p(t.type) ? "paid" : p(t.type) ? f(n) ? "cancelled" : n : h(t) || m(t.type, t.data) || r && d(r.initialAmount, r.initial_amount, r.gross, r.totalGross, r.total_gross) ? "paid" : r?.canceled === !0 && f(n) ? "cancelled" : n === "pending" && (r?.trialEndsAt || r?.trial_ends_at || r?.trialEnds || r?.trial_ends) || (r?.subscriptionId || r?.subscription_id || t.type === "subscription.created" || t.type === "license.created") && n === "pending" ? "trial" : n;
+	return n === "paid" && g(t.type) ? "paid" : g(t.type) ? h(n) ? "cancelled" : n : v(t) || _(t.type, t.data) || r && m(r.initialAmount, r.initial_amount, r.gross, r.totalGross, r.total_gross) ? "paid" : r?.canceled === !0 && h(n) ? "cancelled" : n === "pending" && (r?.trialEndsAt || r?.trial_ends_at || r?.trialEnds || r?.trial_ends) || (r?.subscriptionId || r?.subscription_id || t.type === "subscription.created" || t.type === "license.created") && n === "pending" ? "trial" : n;
 }
-function y(e, ...t) {
+function S(e, ...t) {
 	let n = t.filter((e) => !!e);
 	return e === "paid" || n.includes("paid") ? "paid" : n.includes("cancelled") ? "cancelled" : n.includes("trial") ? "trial" : n.includes("shipped") ? "shipped" : n.includes("refunded") ? "refunded" : e;
 }
-function b(e, t) {
+function C(e, t) {
 	let n = {
 		freemius_last_event_type: t,
 		freemius_last_synced_at: (/* @__PURE__ */ new Date()).toISOString()
@@ -78,26 +80,26 @@ function b(e, t) {
 	for (let [t, r] of Object.entries(e)) r != null && r !== "" && (n[t] = r);
 	return n;
 }
-function x() {
+function w() {
 	let e = process.env.NEXT_PUBLIC_SUPABASE_URL || process.env.SUPABASE_URL, t = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_SECRET_KEY;
 	if (!e || !t) throw Error("Missing Supabase Service Role environment variables");
-	return a(e, t, { auth: {
+	return c(e, t, { auth: {
 		autoRefreshToken: !1,
 		persistSession: !1
 	} });
 }
-async function S(e, t) {
-	let { data: n, error: r } = await e.from("orders").select("id, status, provider, freemius_product_id, freemius_plan_id, freemius_license_id, freemius_subscription_id, freemius_trial_id, freemius_user_id, freemius_trial_ends_at").eq("id", t).single();
+async function T(e, t) {
+	let { data: n, error: r } = await e.from("orders").select("id, status, provider, created_at, freemius_product_id, freemius_plan_id, freemius_license_id, freemius_subscription_id, freemius_trial_id, freemius_user_id, freemius_trial_ends_at").eq("id", t).single();
 	if (r || !n) throw Error(r?.message || "Order not found");
 	return n;
 }
-async function C(e, t) {
-	let { data: n, error: r } = await e.from("orders").select("id, status, provider, freemius_product_id, freemius_plan_id, freemius_license_id, freemius_subscription_id, freemius_trial_id, freemius_user_id, freemius_trial_ends_at").eq("freemius_license_id", t).order("created_at", { ascending: !1 }).limit(1).maybeSingle();
+async function E(e, t) {
+	let { data: n, error: r } = await e.from("orders").select("id, status, provider, created_at, freemius_product_id, freemius_plan_id, freemius_license_id, freemius_subscription_id, freemius_trial_id, freemius_user_id, freemius_trial_ends_at").eq("freemius_license_id", t).order("created_at", { ascending: !1 }).limit(1).maybeSingle();
 	if (r) throw Error(r.message);
 	return n ?? null;
 }
-async function w(e) {
-	let t = b(e.metadata, e.eventType), n = e.order.status, a = n === "paid" && e.nextStatus !== "paid" ? "paid" : e.nextStatus;
+async function D(e) {
+	let t = C(e.metadata, e.eventType), n = e.order.status, a = n === "paid" && e.nextStatus !== "paid" ? "paid" : e.nextStatus;
 	a !== n && (t.status = a);
 	let { error: o } = await e.client.from("orders").update(t).eq("id", e.order.id);
 	if (o) throw Error(o.message);
@@ -106,77 +108,162 @@ async function w(e) {
 		client: e.client
 	}), await r(e.client, e.order.id)), a;
 }
-async function T(e) {
-	let t = e.client ?? x(), n = await S(t, e.orderId);
+var O = 3e5, k = "This checkout could not be verified with Freemius. Your license key is in your purchase email.";
+function A(e) {
+	let t = d(e.licenseId), n = d(e.order.freemius_product_id);
+	if (!t) return {
+		ok: !1,
+		reason: "no_license_in_callback"
+	};
+	if (!n) return {
+		ok: !1,
+		reason: "missing_order_product"
+	};
+	let r = d(e.order.freemius_license_id);
+	if (r && r !== t) return {
+		ok: !1,
+		reason: "order_has_other_license"
+	};
+	if (e.linkedToOtherOrder) return {
+		ok: !1,
+		reason: "license_linked_to_other_order"
+	};
+	let i = a({
+		license: e.license,
+		now: e.now,
+		request: {
+			email: e.callbackEmail ?? "",
+			kind: "purchase",
+			licenseId: t,
+			productId: n,
+			userId: d(e.callbackUserId) ?? ""
+		},
+		user: e.user
+	});
+	if (!i.ok) return i;
+	let s = e.order.created_at ? Date.parse(e.order.created_at) : NaN, c = o(e.license?.created);
+	return !Number.isFinite(s) || c === null || c < s - O ? {
+		ok: !1,
+		reason: "license_predates_order"
+	} : { ok: !0 };
+}
+async function j(e, t, n) {
+	let { data: r, error: i } = await e.from("orders").select("id").eq("freemius_license_id", t).neq("id", n).limit(1);
+	if (i) throw Error(i.message);
+	return Array.isArray(r) && r.length > 0;
+}
+async function M(e) {
+	let t = e.client ?? w(), n = await T(t, e.orderId);
 	if (n.provider !== "freemius") return {
 		success: !1,
 		error: "Only Freemius orders can be synced from Freemius checkout"
 	};
-	let r = g(e.checkoutResponse), i = null;
-	if (r.freemius_license_id) try {
-		i = await O(r.freemius_product_id ?? n.freemius_product_id, r.freemius_license_id);
+	let r = y(e.checkoutResponse), i = r.freemius_license_id ?? null, a = d(n.freemius_product_id), o = !!i && d(n.freemius_license_id) === i, c = null;
+	if (!o) {
+		let o;
+		if (!i || !a) o = A({
+			callbackEmail: null,
+			callbackUserId: null,
+			license: null,
+			licenseId: i,
+			linkedToOtherOrder: !1,
+			order: n,
+			user: null
+		});
+		else {
+			let l = await (e.retrieveLicense ?? s)(a, i);
+			if (!l.ok) return console.error(`[Freemius Checkout Sync] Could not verify license ${i} for order ${n.id}: ${l.reason}`), {
+				success: !1,
+				error: k
+			};
+			o = A({
+				callbackEmail: e.checkoutResponse?.user?.email ?? null,
+				callbackUserId: r.freemius_user_id ?? null,
+				license: l.license,
+				licenseId: i,
+				linkedToOtherOrder: await j(t, i, n.id),
+				now: e.now,
+				order: n,
+				user: l.user
+			}), c = l.license;
+		}
+		if (!o.ok) return console.warn(`[Freemius Checkout Sync] Refused license ${i ?? "(none)"} for order ${n.id}: ${o.reason}`), {
+			success: !1,
+			error: k
+		};
+	}
+	let l = {
+		...r,
+		freemius_product_id: a,
+		freemius_plan_id: d(c?.plan_id) ?? d(n.freemius_plan_id) ?? null,
+		freemius_license_id: i,
+		freemius_user_id: d(c?.user_id) ?? d(n.freemius_user_id) ?? null
+	}, u = null;
+	if (i) try {
+		u = await F(a, i);
 	} catch (e) {
 		console.error("[Freemius Checkout Sync] Failed to retrieve purchase data:", e);
 	}
-	let a = {
+	let f = {
 		type: "checkout.purchaseCompleted",
 		data: { license_id: r.freemius_license_id },
 		objects: {}
-	}, o = {
-		...r,
-		...D(a, i)
-	}, s = _(e.checkoutResponse, n.status), c = i ? v({
-		event: a,
+	}, p = {
+		...l,
+		...P(f, u),
+		freemius_product_id: a
+	}, m = b(e.checkoutResponse, n.status), h = u ? x({
+		event: f,
 		currentStatus: n.status,
-		purchaseData: i
-	}) : null, l = s === "paid" ? n.status : s, u = await w({
+		purchaseData: u
+	}) : null, g = m === "paid" ? n.status : m, _ = await D({
 		client: t,
 		order: n,
-		nextStatus: y(n.status, l, c),
-		metadata: o,
+		nextStatus: S(n.status, g, h),
+		metadata: p,
 		eventType: "checkout.purchaseCompleted"
 	});
 	return {
 		success: !0,
 		orderId: n.id,
-		status: u,
-		metadata: o
+		status: _,
+		metadata: p
 	};
 }
-function E(e) {
-	return c(e.data?.license_id) ?? c(e.objects?.license?.id) ?? c(e.objects?.subscription?.license_id) ?? c(e.objects?.payment?.license_id) ?? c(e.data?.payment?.license_id);
+function N(e) {
+	return d(e.data?.license_id) ?? d(e.objects?.license?.id) ?? d(e.objects?.subscription?.license_id) ?? d(e.objects?.payment?.license_id) ?? d(e.data?.payment?.license_id);
 }
-function D(e, t) {
+function P(e, t) {
 	let n = e.objects?.license, r = e.objects?.subscription, i = e.objects?.trial, a = e.objects?.payment ?? e.data?.payment;
 	return {
-		freemius_product_id: c(t?.productId) ?? c(t?.product_id) ?? c(n?.plugin_id) ?? c(r?.plugin_id) ?? c(a?.plugin_id),
-		freemius_plan_id: c(t?.planId) ?? c(t?.plan_id) ?? c(n?.plan_id),
-		freemius_license_id: c(t?.licenseId) ?? c(t?.license_id) ?? E(e),
-		freemius_subscription_id: c(t?.subscriptionId) ?? c(t?.subscription_id) ?? c(r?.id) ?? c(e.data?.subscription_id),
-		freemius_trial_id: c(i?.id) ?? c(e.data?.trial_id),
-		freemius_user_id: c(t?.userId) ?? c(t?.user_id) ?? c(e.objects?.user?.id),
-		freemius_trial_ends_at: l(i?.trial_ends_at) ?? l(i?.trial_ends) ?? l(n?.trial_ends) ?? l(t?.trialEndsAt) ?? l(t?.trial_ends_at)
+		freemius_product_id: d(t?.productId) ?? d(t?.product_id) ?? d(n?.plugin_id) ?? d(r?.plugin_id) ?? d(a?.plugin_id),
+		freemius_plan_id: d(t?.planId) ?? d(t?.plan_id) ?? d(n?.plan_id),
+		freemius_license_id: d(t?.licenseId) ?? d(t?.license_id) ?? N(e),
+		freemius_subscription_id: d(t?.subscriptionId) ?? d(t?.subscription_id) ?? d(r?.id) ?? d(e.data?.subscription_id),
+		freemius_trial_id: d(i?.id) ?? d(e.data?.trial_id),
+		freemius_user_id: d(t?.userId) ?? d(t?.user_id) ?? d(e.objects?.user?.id),
+		freemius_trial_ends_at: f(i?.trial_ends_at) ?? f(i?.trial_ends) ?? f(n?.trial_ends) ?? f(t?.trialEndsAt) ?? f(t?.trial_ends_at)
 	};
 }
-async function O(e, t) {
+async function F(e, t) {
 	if (!e) return null;
 	let r = n(e);
-	return !r.apiKey || !r.secretKey || !r.publicKey ? null : new s({
+	return !r.apiKey || !r.secretKey || !r.publicKey ? null : new u({
 		productId: Number(e),
 		apiKey: r.apiKey,
 		secretKey: r.secretKey,
 		publicKey: r.publicKey
 	}).purchase.retrievePurchaseData(t);
 }
-async function k(e) {
-	let t = e.client ?? x(), n = E(e.event);
+async function I(e) {
+	let t = e.client ?? w(), n = N(e.event);
 	if (!n) return {
 		success: !0,
 		ignored: !0,
 		reason: "missing_license_id",
 		type: e.event.type
 	};
-	let r = await C(t, n);
+	let r = await E(t, n);
 	if (!r) return {
 		success: !0,
 		ignored: !0,
@@ -186,14 +273,14 @@ async function k(e) {
 	};
 	let i = null;
 	try {
-		i = await O(r.freemius_product_id ?? e.event.objects?.license?.plugin_id, n);
+		i = await F(r.freemius_product_id ?? e.event.objects?.license?.plugin_id, n);
 	} catch (e) {
 		console.error("[Freemius Sync] Failed to retrieve purchase data:", e);
 	}
-	let a = D(e.event, i), o = await w({
+	let a = P(e.event, i), o = await D({
 		client: t,
 		order: r,
-		nextStatus: v({
+		nextStatus: x({
 			event: e.event,
 			currentStatus: r.status,
 			purchaseData: i
@@ -208,7 +295,7 @@ async function k(e) {
 		type: e.event.type
 	};
 }
-function A() {
+function L() {
 	let n = [
 		t("FREEMIUS_SECRET_KEY"),
 		t("FREEMIUS_ECOMMERCE_SANDBOX_SECRET_KEY"),
@@ -216,15 +303,15 @@ function A() {
 	];
 	return Array.from(new Set(n.filter((e) => !!e)));
 }
-function j(e, t) {
-	return t ? A().some((n) => {
-		let r = o.createHmac("sha256", n).update(e).digest("hex");
+function R(e, t) {
+	return t ? L().some((n) => {
+		let r = l.createHmac("sha256", n).update(e).digest("hex");
 		try {
-			return o.timingSafeEqual(Buffer.from(r, "hex"), Buffer.from(t, "hex"));
+			return l.timingSafeEqual(Buffer.from(r, "hex"), Buffer.from(t, "hex"));
 		} catch {
 			return !1;
 		}
 	}) : !1;
 }
 //#endregion
-export { g as extractFreemiusCheckoutMetadata, A as getFreemiusWebhookSecretCandidates, _ as resolveFreemiusStatusFromCheckoutResponse, v as resolveFreemiusStatusFromWebhookEvent, T as syncFreemiusCheckoutOrder, k as syncFreemiusOrderFromWebhookEvent, j as verifyFreemiusWebhookSignature };
+export { k as FREEMIUS_CHECKOUT_SYNC_REFUSED_MESSAGE, A as evaluateFreemiusCheckoutLicense, y as extractFreemiusCheckoutMetadata, L as getFreemiusWebhookSecretCandidates, b as resolveFreemiusStatusFromCheckoutResponse, x as resolveFreemiusStatusFromWebhookEvent, M as syncFreemiusCheckoutOrder, I as syncFreemiusOrderFromWebhookEvent, R as verifyFreemiusWebhookSignature };

package/lib/freemius-pricing-server.cjs

@@ -0,0 +1 @@
+const e=require("./currency.cjs"),t=require("./freemius-pricing.cjs");let n=require("@nextblock-cms/utils");require("server-only");var r=`id, translation_group_id, price, prices, sale_price, sale_prices, sale_start_at, sale_end_at, scheduled_price, scheduled_prices, scheduled_price_at`;async function i(e,t){let n=[t.id];if(t.translation_group_id){let{data:r,error:i}=await e.from(`products`).select(`id`).eq(`translation_group_id`,t.translation_group_id);if(i)throw Error(i.message);n=[...new Set([t.id,...(r||[]).map(e=>e.id)])]}let{data:r,error:i}=await e.from(`freemius_plans`).select(`id`).in(`product_id`,n);if(i)throw Error(i.message);if(!r||r.length===0)return null;let{data:a,error:o}=await e.from(`freemius_pricing`).select(`id, license_quota, api_monthly_price, api_annual_price, api_lifetime_price`).in(`plan_id`,r.map(e=>e.id)).eq(`is_active`,!0).order(`license_quota`,{ascending:!0,nullsFirst:!1}).order(`id`,{ascending:!0}).limit(1);if(o)throw Error(o.message);return a?.[0]??null}async function a(r){let{product:a,currencies:o}=r,s=r.now??new Date,c=r.billingCycle,l=c!=null&&c!==``;if(l&&!t.isFreemiusBillingCycle(c))return{ok:!1,reason:`invalid_billing_cycle`};let u=r.tierCache?.get(a.id);u||(u=i(r.client,a),r.tierCache?.set(a.id,u));let d=await u;if(!d){let t=e.resolveEffectivePriceForCurrency({prices:e.normalizePriceMap(a.prices),salePrices:e.normalizeSalePriceMap(a.sale_prices),fallbackPrice:a.price,fallbackSalePrice:a.sale_price,saleStartAt:a.sale_start_at,saleEndAt:a.sale_end_at,scheduledPrice:a.scheduled_price,scheduledPrices:e.normalizePriceMap(a.scheduled_prices),scheduledPriceAt:a.scheduled_price_at,currencyCode:r.currencyCode,currencies:o,now:s});return{ok:!0,source:`product`,billingCycle:l?c:null,price:t.price,unitAmount:t.sale_price??t.price}}let f={monthly:t.toFreemiusCyclePrice(d.api_monthly_price),annual:t.toFreemiusCyclePrice(d.api_annual_price),lifetime:t.toFreemiusCyclePrice(d.api_lifetime_price)},p=t.resolveFreemiusBillingCycle(c,f);if(!p.ok)return p;let m=e.getDefaultCurrency(o),h=e.convertMinorUnitAmount({amount:(0,n.majorUnitAmountToMinor)(f[p.cycle]??0,m.code),fromCurrencyCode:m.code,toCurrencyCode:r.currencyCode,currencies:o,applyRounding:!0}),g=e.isSaleWindowActive({saleStartAt:a.sale_start_at,saleEndAt:a.sale_end_at,now:s})?t.computeFreemiusSaleDiscountPercent(a.price,a.sale_price):null;return{ok:!0,source:`pricing`,billingCycle:p.cycle,price:h,unitAmount:g===null?h:h-Math.round(h*g/100)}}exports.FREEMIUS_PRICED_PRODUCT_COLUMNS=r,exports.resolveFreemiusUnitAmount=a;

package/lib/freemius-pricing-server.d.ts

@@ -0,0 +1,65 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+import { CurrencyRecord } from './currency';
+import { BillingCycle } from './types';
+type SupabaseLikeClient = SupabaseClient<any>;
+/** The `products` columns the resolver reads; select all of them. */
+export declare const FREEMIUS_PRICED_PRODUCT_COLUMNS = "id, translation_group_id, price, prices, sale_price, sale_prices, sale_start_at, sale_end_at, scheduled_price, scheduled_prices, scheduled_price_at";
+export type FreemiusPricedProduct = {
+    id: string;
+    translation_group_id?: string | null;
+    price: number | null;
+    prices?: Record<string, unknown> | null;
+    sale_price?: number | null;
+    sale_prices?: Record<string, unknown> | null;
+    sale_start_at?: string | null;
+    sale_end_at?: string | null;
+    scheduled_price?: number | null;
+    scheduled_prices?: Record<string, unknown> | null;
+    scheduled_price_at?: string | null;
+};
+type FreemiusPricingRow = {
+    id: string;
+    license_quota: number | null;
+    api_monthly_price: number | string | null;
+    api_annual_price: number | string | null;
+    api_lifetime_price: number | string | null;
+};
+/**
+ * Tier lookups keyed by product id, shared across one quote. The public coupon action prices a
+ * client-supplied line list, so without it repeating one product N times costs 3N queries.
+ */
+export type FreemiusPricingTierCache = Map<string, Promise<FreemiusPricingRow | null>>;
+export type FreemiusUnitAmountResolution = {
+    ok: true;
+    /** `pricing`: the plan's Freemius price for the cycle. `product`: no pricing rows, so `products.price`. */
+    source: 'pricing' | 'product';
+    /** The cycle to send to Freemius. Null only on the `product` fallback when none was asked for. */
+    billingCycle: BillingCycle | null;
+    /** Regular unit price, in the selected currency's minor units. */
+    price: number;
+    /** What the order records per unit: `price` less an active sale. */
+    unitAmount: number;
+} | {
+    ok: false;
+    reason: 'invalid_billing_cycle' | 'billing_cycle_not_offered';
+};
+/**
+ * The unit amount a Freemius purchase is recorded and discounted at.
+ *
+ * Freemius charges its own plan price for the cycle the checkout opens on, so that is what the
+ * order records: the `api_*` price (what Freemius charges, never a display override) for the
+ * validated cycle, converted from the store's default currency into the selected one the way
+ * the product page converts it. An active sale comes off as the percent the Freemius sale coupon
+ * carries. `products.price` is used only when the product has no pricing rows at all; it is the
+ * sync's cycle-blind annual-first price, so pricing it for a monthly purchase over-records it.
+ */
+export declare function resolveFreemiusUnitAmount(input: {
+    client: SupabaseLikeClient;
+    product: FreemiusPricedProduct;
+    billingCycle?: unknown;
+    currencyCode: string;
+    currencies: CurrencyRecord[];
+    tierCache?: FreemiusPricingTierCache;
+    now?: Date;
+}): Promise<FreemiusUnitAmountResolution>;
+export {};

package/lib/freemius-pricing-server.es.js

@@ -0,0 +1,82 @@
+import { convertMinorUnitAmount as e, getDefaultCurrency as t, isSaleWindowActive as n, normalizePriceMap as r, normalizeSalePriceMap as i, resolveEffectivePriceForCurrency as a } from "./currency.es.js";
+import { computeFreemiusSaleDiscountPercent as o, isFreemiusBillingCycle as s, resolveFreemiusBillingCycle as c, toFreemiusCyclePrice as l } from "./freemius-pricing.es.js";
+import { majorUnitAmountToMinor as u } from "@nextblock-cms/utils";
+import "server-only";
+//#region src/lib/freemius-pricing-server.ts
+var d = "id, translation_group_id, price, prices, sale_price, sale_prices, sale_start_at, sale_end_at, scheduled_price, scheduled_prices, scheduled_price_at";
+async function f(e, t) {
+	let n = [t.id];
+	if (t.translation_group_id) {
+		let { data: r, error: i } = await e.from("products").select("id").eq("translation_group_id", t.translation_group_id);
+		if (i) throw Error(i.message);
+		n = [.../* @__PURE__ */ new Set([t.id, ...(r || []).map((e) => e.id)])];
+	}
+	let { data: r, error: i } = await e.from("freemius_plans").select("id").in("product_id", n);
+	if (i) throw Error(i.message);
+	if (!r || r.length === 0) return null;
+	let { data: a, error: o } = await e.from("freemius_pricing").select("id, license_quota, api_monthly_price, api_annual_price, api_lifetime_price").in("plan_id", r.map((e) => e.id)).eq("is_active", !0).order("license_quota", {
+		ascending: !0,
+		nullsFirst: !1
+	}).order("id", { ascending: !0 }).limit(1);
+	if (o) throw Error(o.message);
+	return a?.[0] ?? null;
+}
+async function p(d) {
+	let { product: p, currencies: m } = d, h = d.now ?? /* @__PURE__ */ new Date(), g = d.billingCycle, _ = g != null && g !== "";
+	if (_ && !s(g)) return {
+		ok: !1,
+		reason: "invalid_billing_cycle"
+	};
+	let v = d.tierCache?.get(p.id);
+	v || (v = f(d.client, p), d.tierCache?.set(p.id, v));
+	let y = await v;
+	if (!y) {
+		let e = a({
+			prices: r(p.prices),
+			salePrices: i(p.sale_prices),
+			fallbackPrice: p.price,
+			fallbackSalePrice: p.sale_price,
+			saleStartAt: p.sale_start_at,
+			saleEndAt: p.sale_end_at,
+			scheduledPrice: p.scheduled_price,
+			scheduledPrices: r(p.scheduled_prices),
+			scheduledPriceAt: p.scheduled_price_at,
+			currencyCode: d.currencyCode,
+			currencies: m,
+			now: h
+		});
+		return {
+			ok: !0,
+			source: "product",
+			billingCycle: _ ? g : null,
+			price: e.price,
+			unitAmount: e.sale_price ?? e.price
+		};
+	}
+	let b = {
+		monthly: l(y.api_monthly_price),
+		annual: l(y.api_annual_price),
+		lifetime: l(y.api_lifetime_price)
+	}, x = c(g, b);
+	if (!x.ok) return x;
+	let S = t(m), C = e({
+		amount: u(b[x.cycle] ?? 0, S.code),
+		fromCurrencyCode: S.code,
+		toCurrencyCode: d.currencyCode,
+		currencies: m,
+		applyRounding: !0
+	}), w = n({
+		saleStartAt: p.sale_start_at,
+		saleEndAt: p.sale_end_at,
+		now: h
+	}) ? o(p.price, p.sale_price) : null;
+	return {
+		ok: !0,
+		source: "pricing",
+		billingCycle: x.cycle,
+		price: C,
+		unitAmount: w === null ? C : C - Math.round(C * w / 100)
+	};
+}
+//#endregion
+export { d as FREEMIUS_PRICED_PRODUCT_COLUMNS, p as resolveFreemiusUnitAmount };

package/lib/freemius-pricing.cjs

@@ -0,0 +1 @@
+var e=[`annual`,`monthly`,`lifetime`];function t(t){return typeof t==`string`&&e.includes(t)}function n(e){if(e==null||e===``)return null;let t=Number(e);return Number.isFinite(t)&&t>=0?t:null}function r(e,t){let n=typeof e.license_quota==`number`?e.license_quota:null,r=typeof t.license_quota==`number`?t.license_quota:null;return n===r?e.id<t.id?-1:+(e.id>t.id):n===null?1:r===null?-1:n-r}function i(e){let t=e.filter(e=>e.is_active!==!1);return t.sort(r),t[0]??null}function a(n,r){if(n==null||n===``){let t=e.find(e=>r[e]!==null);return t?{ok:!0,cycle:t}:{ok:!1,reason:`billing_cycle_not_offered`}}return t(n)?r[n]===null?{ok:!1,reason:`billing_cycle_not_offered`}:{ok:!0,cycle:n}:{ok:!1,reason:`invalid_billing_cycle`}}function o(e,t){if(typeof e!=`number`||e<=0||typeof t!=`number`||t<0||t>=e)return null;let n=Math.round((1-t/e)*100);return n<=0||n>100?null:n}exports.FREEMIUS_BILLING_CYCLES=e,exports.compareFreemiusPricingTiers=r,exports.computeFreemiusSaleDiscountPercent=o,exports.isFreemiusBillingCycle=t,exports.pickFreemiusPricingTier=i,exports.resolveFreemiusBillingCycle=a,exports.toFreemiusCyclePrice=n;

package/lib/freemius-pricing.d.ts

@@ -0,0 +1,53 @@
+import { BillingCycle } from './types';
+/**
+ * Pure Freemius pricing rules shared by the product page (client) and the checkout and coupon
+ * quote (server, see freemius-pricing-server.ts). Both sides must pick the same tier and the
+ * same cycle, or the price the shopper sees, the coupon base and the recorded order drift apart.
+ */
+/**
+ * The cycles a Freemius checkout accepts, in the order a missing cycle defaults through:
+ * Freemius opens on the annual cycle when the plan sells one, and the product page pre-selects
+ * the same way.
+ */
+export declare const FREEMIUS_BILLING_CYCLES: readonly BillingCycle[];
+export declare function isFreemiusBillingCycle(value: unknown): value is BillingCycle;
+/** Major-unit price per cycle for one pricing tier; null means the plan does not sell that cycle. */
+export type FreemiusCyclePrices = Record<BillingCycle, number | null>;
+export declare function toFreemiusCyclePrice(value: unknown): number | null;
+type FreemiusPricingTierLike = {
+    id: string;
+    license_quota: number | null;
+    is_active?: boolean | null;
+};
+/**
+ * `ORDER BY license_quota ASC NULLS LAST, id ASC`, the order the server query uses. Ids are
+ * compared as plain strings (not localeCompare) so lowercase uuids sort as Postgres sorts them.
+ */
+export declare function compareFreemiusPricingTiers(a: FreemiusPricingTierLike, b: FreemiusPricingTierLike): number;
+/**
+ * The tier a Freemius product is sold at: the active tier with the lowest license quota. The
+ * checkout does not pick a license count, so Freemius charges its entry tier, and this is the
+ * tier the product page shows and the order records.
+ */
+export declare function pickFreemiusPricingTier<T extends FreemiusPricingTierLike>(tiers: readonly T[]): T | null;
+export type FreemiusBillingCycleResolution = {
+    ok: true;
+    cycle: BillingCycle;
+} | {
+    ok: false;
+    reason: 'invalid_billing_cycle' | 'billing_cycle_not_offered';
+};
+/**
+ * Validates the cycle a cart line asks for against the cycles the tier sells. No cycle (a grid
+ * "add to cart" sends none) resolves to the first one sold, in FREEMIUS_BILLING_CYCLES order.
+ * Anything that is not a cycle name, or a cycle without a price, is refused: the value is
+ * appended to the Freemius checkout as sent, so it is never passed through unchecked.
+ */
+export declare function resolveFreemiusBillingCycle(requested: unknown, prices: FreemiusCyclePrices): FreemiusBillingCycleResolution;
+/**
+ * The whole-percent discount a product sale becomes on Freemius. The sale coupon pushed to
+ * Freemius (syncProductSaleCouponToFreemius) carries this percent, and Freemius applies it to
+ * whichever cycle is bought, so the checkout records the sale with the same percent.
+ */
+export declare function computeFreemiusSaleDiscountPercent(price?: number | null, salePrice?: number | null): number | null;
+export {};

package/lib/freemius-pricing.es.js

@@ -0,0 +1,51 @@
+//#region src/lib/freemius-pricing.ts
+var e = [
+	"annual",
+	"monthly",
+	"lifetime"
+];
+function t(t) {
+	return typeof t == "string" && e.includes(t);
+}
+function n(e) {
+	if (e == null || e === "") return null;
+	let t = Number(e);
+	return Number.isFinite(t) && t >= 0 ? t : null;
+}
+function r(e, t) {
+	let n = typeof e.license_quota == "number" ? e.license_quota : null, r = typeof t.license_quota == "number" ? t.license_quota : null;
+	return n === r ? e.id < t.id ? -1 : +(e.id > t.id) : n === null ? 1 : r === null ? -1 : n - r;
+}
+function i(e) {
+	let t = e.filter((e) => e.is_active !== !1);
+	return t.sort(r), t[0] ?? null;
+}
+function a(n, r) {
+	if (n == null || n === "") {
+		let t = e.find((e) => r[e] !== null);
+		return t ? {
+			ok: !0,
+			cycle: t
+		} : {
+			ok: !1,
+			reason: "billing_cycle_not_offered"
+		};
+	}
+	return t(n) ? r[n] === null ? {
+		ok: !1,
+		reason: "billing_cycle_not_offered"
+	} : {
+		ok: !0,
+		cycle: n
+	} : {
+		ok: !1,
+		reason: "invalid_billing_cycle"
+	};
+}
+function o(e, t) {
+	if (typeof e != "number" || e <= 0 || typeof t != "number" || t < 0 || t >= e) return null;
+	let n = Math.round((1 - t / e) * 100);
+	return n <= 0 || n > 100 ? null : n;
+}
+//#endregion
+export { e as FREEMIUS_BILLING_CYCLES, r as compareFreemiusPricingTiers, o as computeFreemiusSaleDiscountPercent, t as isFreemiusBillingCycle, i as pickFreemiusPricingTier, a as resolveFreemiusBillingCycle, n as toFreemiusCyclePrice };

package/lib/invoice-server.cjs

@@ -1,4 +1,4 @@
-const e=require("./customer.cjs"),t=require("./invoice.cjs"),n=require("./order-tax-details.cjs");let r=require("@nextblock-cms/db/server");function i(e){return e?e.startsWith(`http`)||e.startsWith(`/`)?e:process.env.NEXT_PUBLIC_R2_BASE_URL?`${process.env.NEXT_PUBLIC_R2_BASE_URL}/${e}`:process.env.NEXT_PUBLIC_SUPABASE_URL?`${process.env.NEXT_PUBLIC_SUPABASE_URL}/storage/v1/object/public/media/${e}`:e:null}function a(e){return e??(0,r.getServiceRoleSupabaseClient)()}function o(e){if(!e)return null;let t=e.media?.object_key??e.media?.file_path??null;return{id:e.id,name:e.name??null,url:i(t),width:e.media?.width??null,height:e.media?.height??null}}var s=`active_logo_id`,c=`
+const e=require("./customer.cjs"),t=require("./invoice.cjs"),n=require("./order-tax-details.cjs");require("server-only");let r=require("@nextblock-cms/db/server");function i(e){return e?e.startsWith(`http`)||e.startsWith(`/`)?e:process.env.NEXT_PUBLIC_R2_BASE_URL?`${process.env.NEXT_PUBLIC_R2_BASE_URL}/${e}`:process.env.NEXT_PUBLIC_SUPABASE_URL?`${process.env.NEXT_PUBLIC_SUPABASE_URL}/storage/v1/object/public/media/${e}`:e:null}function a(e){return e??(0,r.getServiceRoleSupabaseClient)()}function o(e){if(!e)return null;let t=e.media?.object_key??e.media?.file_path??null;return{id:e.id,name:e.name??null,url:i(t),width:e.media?.width??null,height:e.media?.height??null}}var s=`active_logo_id`,c=`
         id,
         name,
         media:media_id (