@freemius/sdk 0.0.1 → 0.0.2

package/dist/index.js

@@ -24,6 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 const crypto = __toESM(require("crypto"));
 const openapi_fetch = __toESM(require("openapi-fetch"));
 const __freemius_checkout = __toESM(require("@freemius/checkout"));
+const zod = __toESM(require("zod"));
 
 //#region src/contracts/types.ts
 /**
@@ -107,18 +108,35 @@ function parsePaymentMethod(gateway) {
 	return gateway?.startsWith("stripe") ? "card" : gateway?.startsWith("paypal") ? "paypal" : null;
 }
 
+//#endregion
+//#region package.json
+var version = "0.0.2";
+
 //#endregion
 //#region src/api/client.ts
+function detectPlatform() {
+	if (typeof globalThis !== "undefined" && "Bun" in globalThis) return "Bun";
+	if (typeof globalThis !== "undefined" && "Deno" in globalThis) return "Deno";
+	if (typeof globalThis !== "undefined" && "process" in globalThis && globalThis.process && typeof globalThis.process === "object" && "versions" in globalThis.process && globalThis.process.versions && "node" in globalThis.process.versions) return "Node";
+	if (typeof globalThis !== "undefined" && "window" in globalThis) return "Browser";
+	return "Unknown";
+}
 function createApiClient(baseUrl, bearerToken) {
-	return (0, openapi_fetch.default)({
+	const platform = detectPlatform();
+	const client = (0, openapi_fetch.default)({
 		baseUrl,
-		headers: { Authorization: bearerToken ? `Bearer ${bearerToken}` : void 0 }
+		headers: {
+			Authorization: `Bearer ${bearerToken}`,
+			"User-Agent": `Freemius-JS-SDK/${version} (${platform})`
+		}
 	});
+	return client;
 }
 
 //#endregion
 //#region src/api/ApiBase.ts
-const PAGING_DEFAULT_LIMIT = 150;
+const PAGING_MAX_LIMIT = 50;
+const PAGING_DEFAULT_LIMIT = PAGING_MAX_LIMIT;
 const defaultPagingOptions = {
 	count: PAGING_DEFAULT_LIMIT,
 	offset: 0
@@ -165,6 +183,15 @@ var ApiBase = class {
 	isGoodResponse(response) {
 		return response.status >= 200 && response.status < 300;
 	}
+	/**
+	* @note - We must use this serializer when sending arrays as query parameter to our API.
+	*/
+	getQuerySerializerForArray() {
+		return { array: {
+			explode: false,
+			style: "form"
+		} };
+	}
 };
 
 //#endregion
@@ -215,7 +242,7 @@ var License = class extends ApiBase {
 var Product = class extends ApiBase {
 	async retrieve() {
 		const response = await this.client.GET(`/products/{product_id}.json`, { params: { path: { product_id: this.productId } } });
-		if (response.response.status !== 200 || !response.data) return null;
+		if (!this.isGoodResponse(response.response) || !response.data) return null;
 		return response.data;
 	}
 	async retrieveMany() {
@@ -223,32 +250,71 @@ var Product = class extends ApiBase {
 	}
 	async retrievePricingData() {
 		const response = await this.client.GET(`/products/{product_id}/pricing.json`, { params: { path: { product_id: this.productId } } });
-		if (response.response.status !== 200 || !response.data) return null;
+		if (!this.isGoodResponse(response.response) || !response.data) return null;
 		return response.data;
 	}
+	async retrieveSubscriptionCancellationCoupon() {
+		const response = await this.client.GET(`/products/{product_id}/coupons/special.json`, { params: {
+			path: { product_id: this.productId },
+			query: { type: "subscription_cancellation" }
+		} });
+		if (!this.isGoodResponse(response.response) || !response.data || !response.data.coupon_entities) return null;
+		return response.data.coupon_entities;
+	}
 };
 
 //#endregion
 //#region src/api/Subscription.ts
 var Subscription = class extends ApiBase {
 	async retrieve(subscriptionId) {
-		const response = await this.client.GET(`/products/{product_id}/subscriptions/{subscription_id}.json`, { params: { path: {
+		const result = await this.client.GET(`/products/{product_id}/subscriptions/{subscription_id}.json`, { params: { path: {
 			product_id: this.productId,
 			subscription_id: this.getIdForPath(subscriptionId)
 		} } });
-		if (response.response.status !== 200 || !response.data || !response.data.id) return null;
-		return response.data;
+		if (!this.isGoodResponse(result.response) || !result.data || !result.data.id) return null;
+		return result.data;
 	}
 	async retrieveMany(filter, pagination) {
-		const response = await this.client.GET(`/products/{product_id}/subscriptions.json`, { params: {
+		const result = await this.client.GET(`/products/{product_id}/subscriptions.json`, { params: {
 			path: { product_id: this.productId },
 			query: {
 				...this.getPagingParams(pagination),
 				...filter ?? {}
 			}
 		} });
-		if (response.response.status !== 200 || !response.data || !Array.isArray(response.data.subscriptions)) return [];
-		return response.data.subscriptions;
+		if (!this.isGoodResponse(result.response) || !result.data || !Array.isArray(result.data.subscriptions)) return [];
+		return result.data.subscriptions;
+	}
+	async applyRenewalCoupon(subscriptionId, couponId, logAutoRenew) {
+		const result = await this.client.PUT(`/products/{product_id}/subscriptions/{subscription_id}.json`, {
+			params: { path: {
+				product_id: this.productId,
+				subscription_id: this.getIdForPath(subscriptionId)
+			} },
+			body: {
+				auto_renew: logAutoRenew,
+				coupon_id: Number.parseInt(couponId, 10)
+			}
+		});
+		if (!this.isGoodResponse(result.response) || !result.data || !result.data.id) return null;
+		return result.data;
+	}
+	async cancel(subscriptionId, feedback, reasonIds) {
+		const result = await this.client.DELETE(`/products/{product_id}/subscriptions/{subscription_id}.json`, {
+			params: {
+				path: {
+					product_id: this.productId,
+					subscription_id: this.getIdForPath(subscriptionId)
+				},
+				query: {
+					reason: feedback,
+					reason_ids: reasonIds ?? []
+				}
+			},
+			querySerializer: this.getQuerySerializerForArray()
+		});
+		if (!this.isGoodResponse(result.response) || !result.data || !result.data.id) return null;
+		return result.data;
 	}
 };
 
@@ -296,7 +362,7 @@ var User = class extends ApiBase {
 		return billingResponse.data;
 	}
 	async retrieveSubscriptions(userId, filters, pagination) {
-		const response = await this.client.GET(`/products/{product_id}/users/{user_id}/subscriptions.json`, { params: {
+		const result = await this.client.GET(`/products/{product_id}/users/{user_id}/subscriptions.json`, { params: {
 			path: {
 				product_id: this.productId,
 				user_id: this.getIdForPath(userId)
@@ -306,8 +372,15 @@ var User = class extends ApiBase {
 				...this.getPagingParams(pagination)
 			}
 		} });
-		if (response.response.status !== 200 || !response.data || !Array.isArray(response.data.subscriptions)) return [];
-		return response.data.subscriptions;
+		if (!this.isGoodResponse(result.response) || !result.data || !Array.isArray(result.data.subscriptions)) return [];
+		const discountsMap = /* @__PURE__ */ new Map();
+		if (result.data.discounts) Object.entries(result.data.discounts).forEach(([subscriptionId, discounts]) => {
+			discountsMap.set(idToString(subscriptionId), discounts);
+		});
+		return result.data.subscriptions.map((subscription) => ({
+			...subscription,
+			discounts: discountsMap.get(idToString(subscription.id)) || []
+		}));
 	}
 	async retrieveLicenses(userId, filters, pagination) {
 		const response = await this.client.GET(`/products/{product_id}/users/{user_id}/licenses.json`, { params: {
@@ -337,12 +410,74 @@ var User = class extends ApiBase {
 		if (response.response.status !== 200 || !response.data || !Array.isArray(response.data.payments)) return [];
 		return response.data.payments;
 	}
+	async updateBilling(userId, payload) {
+		const response = await this.client.PUT(`/products/{product_id}/users/{user_id}/billing.json`, {
+			params: { path: {
+				product_id: this.productId,
+				user_id: this.getIdForPath(userId)
+			} },
+			body: payload
+		});
+		if (!this.isGoodResponse(response.response) || !response.data || !response.data) return null;
+		return response.data;
+	}
+};
+
+//#endregion
+//#region src/api/Payment.ts
+var Payment = class extends ApiBase {
+	async retrieve(paymentId) {
+		const response = await this.client.GET(`/products/{product_id}/payments/{payment_id}.json`, { params: { path: {
+			product_id: this.productId,
+			payment_id: this.getIdForPath(paymentId)
+		} } });
+		if (!this.isGoodResponse(response.response) || !response.data || !response.data.id) return null;
+		return response.data;
+	}
+	async retrieveMany(filter, pagination) {
+		const response = await this.client.GET(`/products/{product_id}/payments.json`, { params: {
+			path: { product_id: this.productId },
+			query: {
+				...this.getPagingParams(pagination),
+				...filter ?? {}
+			}
+		} });
+		if (!this.isGoodResponse(response.response) || !response.data || !Array.isArray(response.data.payments)) return [];
+		return response.data.payments;
+	}
+	async retrieveInvoice(paymentId) {
+		const response = await this.client.GET(`/products/{product_id}/payments/{payment_id}/invoice.pdf`, {
+			params: { path: {
+				payment_id: this.getIdForPath(paymentId),
+				product_id: this.productId
+			} },
+			parseAs: "blob"
+		});
+		if (!this.isGoodResponse(response.response) || !response.data) return null;
+		return response.data;
+	}
 };
 
+//#endregion
+//#region src/utils/ops.ts
+function splitName(name) {
+	const parts = name.split(" ");
+	return {
+		firstName: parts[0] ?? "",
+		lastName: parts.slice(1).join(" ") ?? ""
+	};
+}
+function isTestServer() {
+	return process.env.FREEMIUS_INTERNAL__IS_DEVELOPMENT_MODE === "true";
+}
+
 //#endregion
 //#region src/services/ApiService.ts
 const API_ENDPOINT_PRODUCTION = "https://api.freemius.com/v1/";
 const API_ENDPOINT_TEST = "http://api.freemius-local.com:8080/v1/";
+/**
+* @todo - Add a proper user-agent string with SDK version.
+*/
 var ApiService = class {
 	client;
 	productId;
@@ -350,18 +485,19 @@ var ApiService = class {
 	license;
 	product;
 	subscription;
+	payment;
 	baseUrl;
 	constructor(productId, apiKey, secretKey, publicKey) {
 		this.secretKey = secretKey;
 		this.publicKey = publicKey;
-		const isTestServer = process.env.FS__INTERNAL__IS_DEVELOPMENT_MODE === "true";
-		this.baseUrl = isTestServer ? API_ENDPOINT_TEST : API_ENDPOINT_PRODUCTION;
+		this.baseUrl = isTestServer() ? API_ENDPOINT_TEST : API_ENDPOINT_PRODUCTION;
 		this.client = createApiClient(this.baseUrl, apiKey);
 		this.productId = idToString(productId);
 		this.user = new User(this.productId, this.client);
 		this.license = new License(this.productId, this.client);
 		this.product = new Product(this.productId, this.client);
 		this.subscription = new Subscription(this.productId, this.client);
+		this.payment = new Payment(this.productId, this.client);
 	}
 	/**
 	* Low level API client for direct access to the Freemius API.
@@ -372,12 +508,15 @@ var ApiService = class {
 	get __unstable_ApiClient() {
 		return this.client;
 	}
+	createSignedUrl(path) {
+		return this.getSignedUrl(this.createUrl(path));
+	}
 	createUrl(path) {
 		path = path.replace(/^\/+/, "");
 		return `${this.baseUrl}products/${this.productId}/${path}`;
 	}
 	/**
-	* Generate signed URL for the given full URL
+	* Generate signed URL for the given full URL. The authentication is valid for 15 minutes only.
 	*/
 	getSignedUrl(fullUrl) {
 		const url = new URL(fullUrl);
@@ -431,49 +570,41 @@ var ApiService = class {
 };
 
 //#endregion
-//#region src/utils/ops.ts
-function splitName(name) {
-	const parts = name.split(" ");
-	return {
-		firstName: parts[0] ?? "",
-		lastName: parts.slice(1).join(" ") ?? ""
-	};
-}
-
-//#endregion
-//#region src/models/CheckoutBuilder.ts
+//#region src/checkout/Checkout.ts
 /**
 * A builder class for constructing checkout parameters. This class provides a fluent
 * API to create Checkout parameters for a product with various configurations.
 *
-*
-*
-* Every method returns a new instance of the builder with the updated options,
-* allowing for method chaining. The final `toOptions()` method returns the constructed
-* `CheckoutOptions` object. So the class itself is immutable and does not modify the original instance.
+* Every method returns the existing instance of the builder for chainability,
+* The final `getOptions()` method returns the constructed `CheckoutOptions` object.
 */
-var CheckoutBuilder = class CheckoutBuilder {
-	constructor(options, productId, publicKey, secretKey) {
-		this.options = options;
+var Checkout = class Checkout {
+	static createSandboxToken(productId, secretKey, publicKey) {
+		const timestamp = Math.floor(Date.now() / 1e3).toString();
+		const token = `${timestamp}${productId}${secretKey}${publicKey}checkout`;
+		return {
+			ctx: timestamp,
+			token: (0, crypto.createHash)("md5").update(token).digest("hex")
+		};
+	}
+	options;
+	constructor(productId, publicKey, secretKey) {
 		this.productId = productId;
 		this.publicKey = publicKey;
 		this.secretKey = secretKey;
+		this.options = { product_id: productId };
 	}
 	/**
 	* Enables sandbox mode for testing purposes.
 	*
 	* @returns A new builder instance with sandbox configuration
 	*/
-	inSandbox() {
-		const timestamp = Math.floor(Date.now() / 1e3).toString();
-		const token = `${timestamp}${this.productId}${this.secretKey}${this.publicKey}checkout`;
-		return new CheckoutBuilder({
+	setSandbox() {
+		this.options = {
 			...this.options,
-			sandbox: {
-				ctx: timestamp,
-				token: (0, crypto.createHash)("md5").update(token).digest("hex")
-			}
-		}, this.productId, this.publicKey, this.secretKey);
+			sandbox: Checkout.createSandboxToken(this.productId, this.secretKey, this.publicKey)
+		};
+		return this;
 	}
 	/**
 	* Sets user information for the checkout session.
@@ -483,7 +614,7 @@ var CheckoutBuilder = class CheckoutBuilder {
 	*
 	* @returns A new builder instance with user configuration
 	*/
-	withUser(user, readonly = true) {
+	setUser(user, readonly = true) {
 		if (!user) return this;
 		let firstName = user.firstName ?? "";
 		let lastName = user.lastName ?? "";
@@ -492,13 +623,14 @@ var CheckoutBuilder = class CheckoutBuilder {
 			firstName = fn;
 			lastName = ln;
 		}
-		return new CheckoutBuilder({
+		this.options = {
 			...this.options,
 			user_email: user.email,
-			user_first_name: firstName,
-			user_last_name: lastName,
+			user_firstname: firstName,
+			user_lastname: lastName,
 			readonly_user: readonly
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Applies recommended UI settings for better user experience.
@@ -506,15 +638,16 @@ var CheckoutBuilder = class CheckoutBuilder {
 	*
 	* @returns A new builder instance with recommended UI settings
 	*/
-	withRecommendation() {
-		return new CheckoutBuilder({
+	setRecommendations() {
+		this.options = {
 			...this.options,
 			fullscreen: true,
 			show_refund_badge: true,
 			show_reviews: true,
 			locale: "auto",
 			currency: "auto"
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Sets the plan ID for the checkout.
@@ -522,11 +655,12 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param planId The plan ID to purchase
 	* @returns A new builder instance with plan ID set
 	*/
-	withPlan(planId) {
-		return new CheckoutBuilder({
+	setPlan(planId) {
+		this.options = {
 			...this.options,
 			plan_id: planId.toString()
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Sets the number of licenses to purchase.
@@ -534,23 +668,26 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param count Number of licenses
 	* @returns A new builder instance with license count set
 	*/
-	withQuota(count) {
-		return new CheckoutBuilder({
+	setQuota(count) {
+		this.options = {
 			...this.options,
 			licenses: count
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
-	withPricing(pricingId) {
-		return new CheckoutBuilder({
+	setPricing(pricingId) {
+		this.options = {
 			...this.options,
 			pricing_id: pricingId.toString()
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
-	withTitle(title) {
-		return new CheckoutBuilder({
+	setTitle(title) {
+		this.options = {
 			...this.options,
 			title
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Sets a coupon code for the checkout.
@@ -559,14 +696,14 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param hideUI Whether to hide the coupon input field from users
 	* @returns A new builder instance with coupon configuration
 	*/
-	withCoupon(options) {
+	setCoupon(options) {
 		const { code: coupon, hideUI = false } = options;
-		const newOptions = {
+		this.options = {
 			...this.options,
+			coupon,
 			hide_coupon: hideUI
 		};
-		if (coupon !== void 0) newOptions.coupon = coupon;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+		return this;
 	}
 	/**
 	* Enables trial mode for the checkout.
@@ -574,11 +711,12 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param mode Trial type - true/false for plan default, or specific 'free'/'paid' mode
 	* @returns A new builder instance with trial configuration
 	*/
-	inTrial(mode = true) {
-		return new CheckoutBuilder({
+	setTrial(mode = true) {
+		this.options = {
 			...this.options,
 			trial: mode
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Configures the visual layout and appearance of the checkout.
@@ -586,14 +724,14 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param options Appearance configuration options
 	* @returns A new builder instance with appearance configuration
 	*/
-	withAppearance(options) {
-		const newOptions = { ...this.options };
-		if (options.layout !== void 0) newOptions.layout = options.layout;
-		if (options.formPosition !== void 0) newOptions.form_position = options.formPosition;
-		if (options.fullscreen !== void 0) newOptions.fullscreen = options.fullscreen;
-		if (options.modalTitle !== void 0) newOptions.modal_title = options.modalTitle;
-		if (options.id !== void 0) newOptions.id = options.id;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+	setAppearance(options) {
+		this.options = { ...this.options };
+		if (options.layout !== void 0) this.options.layout = options.layout;
+		if (options.formPosition !== void 0) this.options.form_position = options.formPosition;
+		if (options.fullscreen !== void 0) this.options.fullscreen = options.fullscreen;
+		if (options.modalTitle !== void 0) this.options.modal_title = options.modalTitle;
+		if (options.id !== void 0) this.options.id = options.id;
+		return this;
 	}
 	/**
 	* Configures discount display settings.
@@ -601,13 +739,13 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param options Discount configuration options
 	* @returns A new builder instance with discount configuration
 	*/
-	withDiscounts(options) {
-		const newOptions = { ...this.options };
-		if (options.annual !== void 0) newOptions.annual_discount = options.annual;
-		if (options.multisite !== void 0) newOptions.multisite_discount = options.multisite;
-		if (options.bundle !== void 0) newOptions.bundle_discount = options.bundle;
-		if (options.showMonthlySwitch !== void 0) newOptions.show_monthly_switch = options.showMonthlySwitch;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+	setDiscounts(options) {
+		this.options = { ...this.options };
+		if (options.annual !== void 0) this.options.annual_discount = options.annual;
+		if (options.multisite !== void 0) this.options.multisite_discount = options.multisite;
+		if (options.bundle !== void 0) this.options.bundle_discount = options.bundle;
+		if (options.showMonthlySwitch !== void 0) this.options.show_monthly_switch = options.showMonthlySwitch;
+		return this;
 	}
 	/**
 	* Configures billing cycle selector interface.
@@ -616,11 +754,11 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param defaultCycle Default billing cycle to select
 	* @returns A new builder instance with billing cycle configuration
 	*/
-	withBillingCycle(defaultCycle, selector) {
-		const newOptions = { ...this.options };
-		if (selector !== void 0) newOptions.billing_cycle_selector = selector;
-		if (defaultCycle !== void 0) newOptions.billing_cycle = defaultCycle;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+	setBillingCycle(defaultCycle, selector) {
+		this.options = { ...this.options };
+		if (selector !== void 0) this.options.billing_cycle_selector = selector;
+		if (defaultCycle !== void 0) this.options.billing_cycle = defaultCycle;
+		return this;
 	}
 	/**
 	* Sets the language/locale for the checkout.
@@ -628,12 +766,12 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param locale Language setting - 'auto', 'auto-beta', or specific locale like 'en_US'
 	* @returns A new builder instance with locale configuration
 	*/
-	withLanguage(locale = "auto") {
-		return new CheckoutBuilder({
+	setLanguage(locale = "auto") {
+		this.options = {
 			...this.options,
-			language: locale,
-			locale
-		}, this.productId, this.publicKey, this.secretKey);
+			language: locale
+		};
+		return this;
 	}
 	/**
 	* Configures review and badge display settings.
@@ -641,13 +779,13 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param options Review and badge configuration
 	* @returns A new builder instance with reviews and badges configuration
 	*/
-	withReviewsAndBadges(options) {
-		const newOptions = { ...this.options };
-		if (options.showReviews !== void 0) newOptions.show_reviews = options.showReviews;
-		if (options.reviewId !== void 0) newOptions.review_id = options.reviewId;
-		if (options.showRefundBadge !== void 0) newOptions.show_refund_badge = options.showRefundBadge;
-		if (options.refundPolicyPosition !== void 0) newOptions.refund_policy_position = options.refundPolicyPosition;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+	setSocialProofing(options) {
+		this.options = { ...this.options };
+		if (options.showReviews !== void 0) this.options.show_reviews = options.showReviews;
+		if (options.reviewId !== void 0) this.options.review_id = options.reviewId;
+		if (options.showRefundBadge !== void 0) this.options.show_refund_badge = options.showRefundBadge;
+		if (options.refundPolicyPosition !== void 0) this.options.refund_policy_position = options.refundPolicyPosition;
+		return this;
 	}
 	/**
 	* Enhanced currency configuration.
@@ -657,14 +795,14 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param showInlineSelector Whether to show inline currency selector
 	* @returns A new builder instance with currency configuration
 	*/
-	withCurrency(currency, defaultCurrency = "usd", showInlineSelector = true) {
-		const options = {
+	setCurrency(currency, defaultCurrency = "usd", showInlineSelector = true) {
+		this.options = {
 			...this.options,
 			show_inline_currency_selector: showInlineSelector,
-			default_currency: defaultCurrency
+			default_currency: defaultCurrency,
+			currency
 		};
-		if (currency !== "auto") options.currency = currency;
-		return new CheckoutBuilder(options, this.productId, this.publicKey, this.secretKey);
+		return this;
 	}
 	/**
 	* Configures navigation and cancel behavior.
@@ -673,11 +811,11 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param cancelIcon Custom cancel icon URL
 	* @returns A new builder instance with navigation configuration
 	*/
-	withNavigation(cancelUrl, cancelIcon) {
-		const newOptions = { ...this.options };
-		if (cancelUrl !== void 0) newOptions.cancel_url = cancelUrl;
-		if (cancelIcon !== void 0) newOptions.cancel_icon = cancelIcon;
-		return new CheckoutBuilder(newOptions, this.productId, this.publicKey, this.secretKey);
+	setCancelButton(cancelUrl, cancelIcon) {
+		this.options = { ...this.options };
+		if (cancelUrl !== void 0) this.options.cancel_url = cancelUrl;
+		if (cancelIcon !== void 0) this.options.cancel_icon = cancelIcon;
+		return this;
 	}
 	/**
 	* Associates purchases with an affiliate account.
@@ -685,11 +823,12 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param userId Affiliate user ID
 	* @returns A new builder instance with affiliate configuration
 	*/
-	withAffiliate(userId) {
-		return new CheckoutBuilder({
+	setAffiliate(userId) {
+		this.options = {
 			...this.options,
 			affiliate_user_id: userId
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Sets a custom image/icon for the checkout.
@@ -697,11 +836,12 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param imageUrl Secure HTTPS URL to the image
 	* @returns A new builder instance with custom image
 	*/
-	withImage(imageUrl) {
-		return new CheckoutBuilder({
+	setImage(imageUrl) {
+		this.options = {
 			...this.options,
 			image: imageUrl
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Configures the checkout for license renewal.
@@ -709,30 +849,131 @@ var CheckoutBuilder = class CheckoutBuilder {
 	* @param licenseKey The license key to renew
 	* @returns A new builder instance configured for renewal
 	*/
-	forRenewal(licenseKey) {
-		return new CheckoutBuilder({
+	setLicenseRenewal(licenseKey) {
+		this.options = {
 			...this.options,
 			license_key: licenseKey
-		}, this.productId, this.publicKey, this.secretKey);
+		};
+		return this;
 	}
 	/**
 	* Builds and returns the final checkout options to be used with the `@freemius/checkout` package.
 	*
+	* @note - This is async by purpose so that we can allow for future enhancements that might require async operations.
+	*
 	* @returns The constructed CheckoutOptions object
 	*/
-	toOptions(additionalOptions) {
-		return {
-			...this.options,
-			...additionalOptions,
-			product_id: this.productId
-		};
+	getOptions() {
+		return { ...this.options };
 	}
-	toLink() {
+	/**
+	* Generates a checkout link based on the current builder state.
+	*
+	* @note - This is async by purpose so that we can allow for future enhancements that might require async operations.
+	*/
+	getLink() {
 		const checkoutOptions = (0, __freemius_checkout.convertCheckoutOptionsToQueryParams)(this.options);
 		const queryParams = (0, __freemius_checkout.buildFreemiusQueryFromOptions)(checkoutOptions);
-		const url = new URL(`https://checkout.freemius.com/product/${this.productId}/`);
+		const url = new URL(`${this.getBaseUrl()}/product/${this.productId}/`);
 		url.search = queryParams;
-		return url.href;
+		return url.toString();
+	}
+	serialize() {
+		return {
+			options: this.getOptions(),
+			link: this.getLink(),
+			baseUrl: this.getBaseUrl()
+		};
+	}
+	getBaseUrl() {
+		return isTestServer() ? "http://checkout.freemius-local.com:8080" : "https://checkout.freemius.com";
+	}
+};
+
+//#endregion
+//#region src/errors/ActionError.ts
+var ActionError = class ActionError extends Error {
+	statusCode;
+	validationIssues;
+	constructor(message, statusCode = 400, validationIssues) {
+		super(message);
+		this.name = "ActionError";
+		this.statusCode = statusCode;
+		this.validationIssues = validationIssues;
+	}
+	toResponse() {
+		const errorResponse = { message: this.message };
+		if (this.validationIssues) errorResponse.issues = this.validationIssues;
+		return Response.json(errorResponse, { status: this.statusCode });
+	}
+	static badRequest(message) {
+		return new ActionError(message, 400);
+	}
+	static unauthorized(message = "Unauthorized") {
+		return new ActionError(message, 401);
+	}
+	static notFound(message = "Not found") {
+		return new ActionError(message, 404);
+	}
+	static validationFailed(message, validationIssues) {
+		return new ActionError(message, 400, validationIssues);
+	}
+	static internalError(message = "Internal server error") {
+		return new ActionError(message, 500);
+	}
+};
+
+//#endregion
+//#region src/checkout/PricingRetriever.ts
+var PricingRetriever = class {
+	constructor(pricing) {
+		this.pricing = pricing;
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return action === "pricing_data";
+	}
+	async processAction(request) {
+		const url = new URL(request.url);
+		const topupPlanId = url.searchParams.get("topupPlanId") || void 0;
+		const pricingData = await this.pricing.retrieve(topupPlanId);
+		return Response.json(pricingData);
+	}
+};
+
+//#endregion
+//#region src/checkout/PurchaseProcessor.ts
+var PurchaseProcessor = class {
+	constructor(purchase, callback) {
+		this.purchase = purchase;
+		this.callback = callback;
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return request.method === "POST" && action === "process_purchase";
+	}
+	async processAction(request) {
+		const purchaseSchema = zod.object({ purchase: zod.object({ license_id: zod.string() }) });
+		const contentType = request.headers.get("content-type");
+		if (!contentType || !contentType.includes("application/json")) throw ActionError.badRequest("Invalid content type. Expected application/json");
+		let requestBody;
+		try {
+			requestBody = await request.json();
+		} catch {
+			throw ActionError.badRequest("Request body must be valid JSON");
+		}
+		const parseResult = purchaseSchema.safeParse(requestBody);
+		if (!parseResult.success) throw ActionError.validationFailed("Invalid request body format", parseResult.error.issues);
+		const { purchase: { license_id: licenseId } } = parseResult.data;
+		const purchase = await this.purchase.retrievePurchase(licenseId);
+		if (!purchase) throw ActionError.notFound("No purchase data found for the provided license ID");
+		if (this.callback) {
+			const callbackResponse = await this.callback(purchase);
+			if (callbackResponse) return callbackResponse;
+		}
+		return Response.json(purchase.toData());
 	}
 };
 
@@ -766,10 +1007,10 @@ var CheckoutRedirectInfo = class {
 		this.action = data.action ? data.action : null;
 		this.amount = parseNumber(data.amount);
 		this.tax = parseNumber(data.tax);
-		this.type = data.type === "subscription" ? "subscription" : "one-off";
 		this.subscription_id = data.subscription_id ? idToString(data.subscription_id) : null;
 		this.billing_cycle = data.billing_cycle ? parseBillingCycle(data.billing_cycle) : null;
 		this.payment_id = data.payment_id ? idToString(data.payment_id) : null;
+		this.type = this.subscription_id ? "subscription" : "one-off";
 	}
 	isSubscription() {
 		return this.type === "subscription";
@@ -795,13 +1036,144 @@ var CheckoutRedirectInfo = class {
 	}
 };
 
+//#endregion
+//#region src/checkout/RedirectProcessor.ts
+var RedirectProcessor = class {
+	constructor(secretKey, proxyUrl, callback, afterProcessUrl) {
+		this.secretKey = secretKey;
+		this.proxyUrl = proxyUrl;
+		this.callback = callback;
+		this.afterProcessUrl = afterProcessUrl;
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		return request.method === "GET" && url.searchParams.has("signature");
+	}
+	async processAction(request) {
+		const info = await this.getRedirectInfo(request.url);
+		if (!info) throw ActionError.badRequest("Invalid or missing redirect signature");
+		if (this.callback) {
+			const callbackResponse = await this.callback(info);
+			if (callbackResponse) return callbackResponse;
+		}
+		const url = new URL(this.afterProcessUrl ?? this.proxyUrl ?? request.url);
+		url.search = "";
+		url.searchParams.set("plan", info.plan_id);
+		url.searchParams.set("is_subscription", info.isSubscription() ? "1" : "0");
+		url.searchParams.set("quote", info.quota?.toString() ?? "0");
+		return Response.redirect(url.href, 302);
+	}
+	async getRedirectInfo(currentUrl) {
+		const url = new URL(currentUrl.replace(/%20/g, "+"));
+		const signature = url.searchParams.get("signature");
+		if (!signature) return null;
+		if (this.proxyUrl) {
+			const proxy = new URL(this.proxyUrl);
+			url.protocol = proxy.protocol;
+			url.host = proxy.host;
+			url.port = proxy.port;
+		}
+		const cleanUrl = this.getCleanUrl(url.href);
+		const calculatedSignature = (0, crypto.createHmac)("sha256", this.secretKey).update(cleanUrl).digest("hex");
+		const result = (0, crypto.timingSafeEqual)(Buffer.from(calculatedSignature), Buffer.from(signature));
+		if (!result) return null;
+		const params = Object.fromEntries(url.searchParams.entries());
+		if (!params.user_id || !params.plan_id || !params.pricing_id || !params.email) return null;
+		return new CheckoutRedirectInfo(params);
+	}
+	getCleanUrl(url) {
+		const signatureParam = "&signature=";
+		const signatureParamFirst = "?signature=";
+		let signaturePos = url.indexOf(signatureParam);
+		if (signaturePos === -1) signaturePos = url.indexOf(signatureParamFirst);
+		if (signaturePos === -1) return url;
+		return url.substring(0, signaturePos);
+	}
+};
+
+//#endregion
+//#region src/checkout/CheckoutRequestProcessor.ts
+var CheckoutRequestProcessor = class {
+	constructor(purchase, pricing, secretKey) {
+		this.purchase = purchase;
+		this.pricing = pricing;
+		this.secretKey = secretKey;
+	}
+	createProcessor(config) {
+		return (request) => this.process(config, request);
+	}
+	async process(config, request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		if (!action) return Response.json({ error: "Action parameter is required" }, { status: 400 });
+		const actionHandlers = [
+			this.getPricingRetriever(),
+			this.getRedirectProcessor({
+				proxyUrl: config.proxyUrl,
+				callback: config.onRedirect,
+				afterProcessUrl: config.afterProcessUrl
+			}),
+			this.getPurchaseProcessor({ callback: config.onPurchase })
+		];
+		try {
+			for (const actionHandler of actionHandlers) if (actionHandler.canHandle(request)) return await actionHandler.processAction(request);
+		} catch (error) {
+			if (error instanceof ActionError) return error.toResponse();
+			console.error("Error processing action:", error);
+			return ActionError.internalError("Internal Server Error").toResponse();
+		}
+		return ActionError.badRequest("Unsupported action").toResponse();
+	}
+	/**
+	* Processes the redirect from Freemius Checkout.
+	*
+	* This method verifies the signature in the URL and returns a CheckoutRedirectInfo object if successful.
+	*
+	* For nextjs like applications, make sure to replace the URL from the `Request` object with the right hostname to take care of the proxy.
+	*
+	* For example, if you have put the nextjs application behind nginx proxy (or ngrok during local development), then nextjs will still see the `request.url` as `https://localhost:3000/...`.
+	* In this case, you should replace it with the actual URL of your application, like `https://xyz.ngrok-free.app/...`.
+	*
+	* @example
+	* ```ts
+	* export async function GET(request: Request) {
+	*     // Replace the URL with the actual hostname of your application
+	*     // This is important for the signature verification to work correctly.
+	*     const data = await freemius.checkout.action.getRedirectProcessor({
+	*          proxyUrl: 'https://xyz.ngrok-free.app',
+	*          async callback(info) {
+	*              // Handle the redirect info here, like creating a license, etc.
+	*              // Return a Response object to override the default redirect behavior.
+	*              return Response.redirect('/custom-success-page', 302);
+	*          },
+	*      });
+	*
+	*     return data.processAction(request);
+	* }
+	* ```
+	*/
+	getRedirectProcessor(config) {
+		return new RedirectProcessor(this.secretKey, config.proxyUrl, config.callback, config.afterProcessUrl);
+	}
+	getPurchaseProcessor(config) {
+		return new PurchaseProcessor(this.purchase, config.callback);
+	}
+	getPricingRetriever() {
+		return new PricingRetriever(this.pricing);
+	}
+};
+
 //#endregion
 //#region src/services/CheckoutService.ts
 var CheckoutService = class {
-	constructor(productId, publicKey, secretKey) {
+	request;
+	constructor(productId, publicKey, secretKey, purchase, pricing) {
 		this.productId = productId;
 		this.publicKey = publicKey;
 		this.secretKey = secretKey;
+		this.purchase = purchase;
+		this.pricing = pricing;
+		this.request = new CheckoutRequestProcessor(this.purchase, this.pricing, this.secretKey);
 	}
 	/**
 	* Use this to build a Checkout for your product.
@@ -814,74 +1186,39 @@ var CheckoutService = class {
 	* @example
 	* Basic usage:
 	* ```typescript
-	* const options = freemius.checkout.params()
-	*   .withUser(session?.user)
-	*   .inSandbox()
-	*   .withRecommendation()
-	*   .toOptions(); // Or .toLink() for a hosted checkout link
+	* const checkout = await freemius.checkout.create({user: session?.user})
+	*   .getOptions(); // Or .getLink() for a hosted checkout link
 	* ```
 	*
 	* @example
-	* Advanced configuration:
+	* Advanced configuration: You can also skip the convenience options and rather use the builder directly to configure the checkout.
+	*
 	* ```typescript
-	* const checkoutOptions = freemius.checkout.params()
-	*   .withUser(user, true)
-	*   .withPlan('1234')
-	*   .withQuota(5)
-	*   .withCurrency('eur')
-	*   .withCoupon({
+	* const checkout = freemius.checkout.create()
+	*   .setUser(user, true)
+	*   .setPlan('1234')
+	*   .setCoupon({
 	*     code: 'DISCOUNT2023',
 	*     hideUI: false
 	*   })
-	*   .inTrial('paid')
-	*   .withAppearance({
-	*     layout: 'horizontal',
-	*     formPosition: 'left',
-	*     fullscreen: true,
-	*     modalTitle: 'Upgrade Now'
-	*   })
-	*   .withDiscounts({
-	*     annual: true,
-	*     multisite: 'auto',
-	*     bundle: 'maximize',
-	*     showMonthlySwitch: true
-	*   })
-	*   .withReviewsAndBadges({
-	*     showReviews: true,
-	*     showRefundBadge: true,
-	*     refundPolicyPosition: 'below_form'
-	*   })
-	*   .withBillingCycle('dropdown', 'annual')
-	*   .withLocale('en_US')
-	*   .withAffiliate(12345)
-	*   .inSandbox()
-	*   .toOptions();
+	*   .setSandbox()
+	*   .getOptions();
 	* ```
-	*/
-	create(withRecommendation = true) {
-		const productId = idToString(this.productId);
-		const builder = new CheckoutBuilder({}, productId, this.publicKey, this.secretKey);
-		return withRecommendation ? builder.withRecommendation() : builder;
-	}
-	/**
-	* Convenience method to create checkout options for a specific user with or without sandbox mode.
-	*
-	* Useful for generating recommended checkout options for SaaS.
-	*/
-	createUserOptions(user, isSandbox = false) {
-		let builder = this.create().withUser(user);
-		if (isSandbox) builder = builder.inSandbox();
-		return builder.toOptions();
-	}
-	/**
-	* Convenience method to create a checkout link for a specific user with or without sandbox mode.
 	*
-	* Useful for generating recommended checkout links for SaaS.
+	* @example
 	*/
-	createUserLink(user, isSandbox = false) {
-		let builder = this.create().withUser(user);
-		if (isSandbox) builder = builder.inSandbox();
-		return builder.toLink();
+	async create(options = {}) {
+		const { user, isSandbox = false, withRecommendation = true, title, image, planId, quota, trial } = options;
+		const builder = new Checkout(idToString(this.productId), this.publicKey, this.secretKey);
+		if (user) builder.setUser(user, true);
+		if (withRecommendation) builder.setRecommendations();
+		if (isSandbox) builder.setSandbox();
+		if (title) builder.setTitle(title);
+		if (image) builder.setImage(image);
+		if (planId) builder.setPlan(planId);
+		if (quota) builder.setQuota(quota);
+		if (trial) builder.setTrial(trial);
+		return builder;
 	}
 	/**
 	* Retrieves the sandbox parameters for the checkout.
@@ -894,114 +1231,159 @@ var CheckoutService = class {
 	*         Also think about whether we should make the builder's `inSandbox` method async as well.
 	*/
 	async getSandboxParams() {
-		const timestamp = Math.floor(Date.now() / 1e3).toString();
-		const token = `${timestamp}${this.productId}${this.secretKey}${this.publicKey}checkout`;
-		return {
-			ctx: timestamp,
-			token: (0, crypto.createHash)("md5").update(token).digest("hex")
-		};
+		return Checkout.createSandboxToken(idToString(this.productId), this.secretKey, this.publicKey);
 	}
 	/**
-	* Processes the redirect from Freemius Checkout.
+	* Processes a redirect URL and returns the checkout redirect information if valid.
 	*
-	* This method verifies the signature in the URL and returns a CheckoutRedirectInfo object if successful.
+	* This is useful for handling redirects from the checkout portal back to your application.
 	*
-	* For nextjs like applications, make sure to replace the URL from the `Request` object with the right hostname to take care of the proxy.
+	* @param url The current URL to process.
+	* @param proxyUrl Optional proxy URL to replace parts of the URL for signature verification.
 	*
-	* For example, if you have put the nextjs application behind nginx proxy (or ngrok during local development), then nextjs will still see the `request.url` as `https://localhost:3000/...`.
-	* In this case, you should replace it with the actual URL of your application, like `https://xyz.ngrok-free.app/...`.
+	* @returns A promise that resolves to the checkout redirect information or null if invalid.
 	*
 	* @example
-	* ```ts
-	* export async function GET(request: Request) {
-	*     // Replace the URL with the actual hostname of your application
-	*     // This is important for the signature verification to work correctly.
-	*     const data = await freemius.checkout.processRedirect(
-	*         request.url.replace('https://localhost:3000', 'https://xyz.ngrok-free.app')
-	*     );
+	* ```typescript
+	* const redirectInfo = await freemius.checkout.processRedirect(window.location.href);
+	*
+	* if (redirectInfo) {
+	*   // Handle valid redirect info
+	* } else {
+	*   // Handle invalid or missing redirect info
 	* }
 	* ```
 	*/
-	async processRedirect(currentUrl) {
-		const url = new URL(currentUrl.replace(/%20/g, "+"));
-		const signature = url.searchParams.get("signature");
-		if (!signature) return null;
-		const cleanUrl = this.getCleanUrl(url.href);
-		const calculatedSignature = (0, crypto.createHmac)("sha256", this.secretKey).update(cleanUrl).digest("hex");
-		const result = (0, crypto.timingSafeEqual)(Buffer.from(calculatedSignature), Buffer.from(signature));
-		if (!result) return null;
-		const params = Object.fromEntries(url.searchParams.entries());
-		if (!params.user_id || !params.plan_id || !params.pricing_id || !params.email) return null;
-		return new CheckoutRedirectInfo(params);
-	}
-	getCleanUrl(url) {
-		const signatureParam = "&signature=";
-		const signatureParamFirst = "?signature=";
-		let signaturePos = url.indexOf(signatureParam);
-		if (signaturePos === -1) signaturePos = url.indexOf(signatureParamFirst);
-		if (signaturePos === -1) return url;
-		return url.substring(0, signaturePos);
+	processRedirect(url, proxyUrl) {
+		const processor = new RedirectProcessor(this.secretKey, proxyUrl);
+		return processor.getRedirectInfo(url);
 	}
 };
 
 //#endregion
-//#region src/services/CustomerPortalService.ts
-var CustomerPortalService = class {
-	constructor(api, checkout) {
+//#region src/customer-portal/PortalDataRepository.ts
+var PortalDataRepository = class {
+	constructor(api, action, checkout) {
 		this.api = api;
+		this.action = action;
 		this.checkout = checkout;
 	}
-	/**
-	* Retrieves the customer portal data for a user, including subscriptions, billing, and payments.
-	*
-	* @param userId The ID of the user for whom to retrieve portal data.
-	* @param primaryLicenseId Optional primary license ID to include in the portal data. If present then the `primary` field will be populated with related information which our `@freemius/saas-starter` package uses to display the primary purchase information.
-	*/
-	async retrieveData(userId, primaryLicenseId = null, sandbox = false) {
-		const [user, pricingData, subscriptions, payments, billing] = await Promise.all([
-			this.api.user.retrieve(userId),
-			this.api.product.retrievePricingData(),
-			this.api.user.retrieveSubscriptions(userId),
-			this.api.user.retrievePayments(userId),
-			this.api.user.retrieveBilling(userId)
-		]);
-		if (!user || !pricingData || !subscriptions) return null;
-		const planTitles = this.getPlanTitleById(pricingData);
-		const allPricingsById = this.getPricingById(pricingData);
-		const portalPayments = payments.map((payment) => ({
-			...payment,
-			invoiceUrl: this.api.getSignedUrl(this.api.createUrl(`payments/${payment.id}/invoice.pdf`)),
-			paymentMethod: parsePaymentMethod(payment.gateway),
-			createdAt: parseDateTime(payment.created) ?? /* @__PURE__ */ new Date(),
-			planTitle: planTitles[payment.plan_id] ?? `Plan ${payment.plan_id}`,
-			quota: allPricingsById[payment.pricing_id]?.licenses ?? null
-		}));
+	async retrievePortalDataByEmail(config) {
+		const user = await this.api.user.retrieveByEmail(config.email);
+		if (!user) return null;
+		return this.retrievePortalData({
+			user,
+			endpoint: config.endpoint,
+			primaryLicenseId: config.primaryLicenseId ?? null,
+			sandbox: config.sandbox ?? false
+		});
+	}
+	async retrievePortalDataByUserId(config) {
+		const user = await this.api.user.retrieve(config.userId);
+		if (!user) return null;
+		return this.retrievePortalData({
+			user,
+			endpoint: config.endpoint,
+			primaryLicenseId: config.primaryLicenseId ?? null,
+			sandbox: config.sandbox ?? false
+		});
+	}
+	async retrievePortalData(config) {
+		const { user, endpoint, primaryLicenseId = null, sandbox = false } = config;
+		const userId = user.id;
+		const data = await this.retrieveApiData(userId);
+		if (!data) return null;
+		const { pricingData, subscriptions, payments, billing, coupons } = data;
+		const plans = this.getPlansById(pricingData);
+		const pricings = this.getPricingById(pricingData);
 		const checkoutOptions = { product_id: this.api.productId };
 		if (sandbox) checkoutOptions.sandbox = await this.checkout.getSandboxParams();
-		const billingData = {
+		const portalData = {
+			endpoint,
 			user,
 			checkoutOptions,
-			billing,
-			subscriptions: {
-				primary: null,
-				active: [],
-				past: []
-			},
-			payments: portalPayments,
+			billing: this.getBilling(billing, userId, endpoint),
+			subscriptions: await this.getSubscriptions(subscriptions, plans, pricings, primaryLicenseId, endpoint),
+			payments: this.getPayments(payments, plans, pricings, userId, endpoint),
 			plans: pricingData.plans ?? [],
-			sellingUnit: pricingData.selling_unit_label ?? {
+			sellingUnit: pricingData.plugin?.selling_unit_label ?? {
 				singular: "Unit",
 				plural: "Units"
 			},
-			productId: this.api.productId
+			productId: this.api.productId,
+			cancellationCoupons: coupons
+		};
+		return portalData;
+	}
+	async retrieveApiData(userId) {
+		const [pricingData, subscriptions, payments, billing, coupons] = await Promise.all([
+			this.api.product.retrievePricingData(),
+			this.api.user.retrieveSubscriptions(userId, {
+				extended: true,
+				enrich_with_cancellation_discounts: true
+			}),
+			this.api.user.retrievePayments(userId),
+			this.api.user.retrieveBilling(userId),
+			this.api.product.retrieveSubscriptionCancellationCoupon()
+		]);
+		if (!pricingData || !subscriptions) return null;
+		return {
+			pricingData,
+			subscriptions,
+			payments,
+			billing,
+			coupons
+		};
+	}
+	getPayments(payments, plans, pricings, userId, endpoint) {
+		return payments.map((payment) => ({
+			...payment,
+			invoiceUrl: this.action.invoice.createAuthenticatedUrl(payment.id, idToString(userId), endpoint),
+			paymentMethod: parsePaymentMethod(payment.gateway),
+			createdAt: parseDateTime(payment.created) ?? /* @__PURE__ */ new Date(),
+			planTitle: plans.get(payment.plan_id)?.title ?? `Plan ${payment.plan_id}`,
+			quota: pricings.get(payment.pricing_id)?.licenses ?? null
+		}));
+	}
+	getPlansById(pricingData) {
+		const plans = /* @__PURE__ */ new Map();
+		pricingData.plans?.forEach((plan) => {
+			plan.title = plan.title ?? plan.name ?? `Plan ${plan.id}`;
+			plans.set(idToString(plan.id), plan);
+		});
+		return plans;
+	}
+	getPricingById(pricingData) {
+		const pricings = /* @__PURE__ */ new Map();
+		pricingData.plans?.forEach((plan) => {
+			plan.pricing?.forEach((p) => {
+				pricings.set(idToString(p.id), p);
+			});
+		});
+		return pricings;
+	}
+	getBilling(billing, userId, endpoint) {
+		return {
+			...billing ?? {},
+			updateUrl: this.action.billing.createAuthenticatedUrl(billing?.id ?? "new", idToString(userId), endpoint)
+		};
+	}
+	async getSubscriptions(subscriptions, plans, pricings, primaryLicenseId = null, endpoint) {
+		const portalSubscriptions = {
+			primary: null,
+			active: [],
+			past: []
 		};
 		subscriptions.forEach((subscription) => {
 			const isActive = null === subscription.canceled_at;
+			const trialEndsData = subscription.trial_ends ? parseDateTime(subscription.trial_ends) : null;
+			const isTrial = trialEndsData ? trialEndsData > /* @__PURE__ */ new Date() : false;
+			const isFreeTrial = isTrial && !subscription.gateway;
 			const subscriptionData = {
 				subscriptionId: idToString(subscription.id),
 				planId: idToString(subscription.plan_id),
 				pricingId: idToString(subscription.pricing_id),
-				planTitle: planTitles[subscription.plan_id] ?? `Plan ${subscription.plan_id}`,
+				planTitle: plans.get(subscription.plan_id)?.title ?? `Plan ${subscription.plan_id}`,
 				renewalAmount: parseNumber(subscription.renewal_amount),
 				initialAmount: parseNumber(subscription.initial_amount),
 				billingCycle: parseBillingCycle(subscription.billing_cycle),
@@ -1011,207 +1393,470 @@ var CustomerPortalService = class {
 				currency: parseCurrency(subscription.currency) ?? CURRENCY.USD,
 				createdAt: parseDateTime(subscription.created) ?? /* @__PURE__ */ new Date(),
 				cancelledAt: subscription.canceled_at ? parseDateTime(subscription.canceled_at) : null,
-				quota: allPricingsById[subscription.pricing_id]?.licenses ?? null,
-				paymentMethod: parsePaymentMethod(subscription.gateway)
+				quota: pricings.get(subscription.pricing_id)?.licenses ?? null,
+				paymentMethod: parsePaymentMethod(subscription.gateway),
+				isTrial,
+				trialEnds: isTrial ? trialEndsData : null,
+				isFreeTrial,
+				applyRenewalCancellationCouponUrl: this.isRenewalCancellationCouponApplicable(subscription) ? this.action.renewalCoupon.createAuthenticatedUrl(idToString(subscription.id), idToString(subscription.user_id), endpoint) : null,
+				cancelRenewalUrl: this.action.cancelRenewal.createAuthenticatedUrl(idToString(subscription.id), idToString(subscription.user_id), endpoint)
 			};
-			if (isActive) billingData.subscriptions.active.push(subscriptionData);
-			else billingData.subscriptions.past.push(subscriptionData);
-			if (isActive && primaryLicenseId && isIdsEqual(subscription.license_id, primaryLicenseId)) billingData.subscriptions.primary = subscriptionData;
+			if (isActive) portalSubscriptions.active.push(subscriptionData);
+			else portalSubscriptions.past.push(subscriptionData);
+			if (isActive && primaryLicenseId && isIdsEqual(subscription.license_id, primaryLicenseId)) portalSubscriptions.primary = subscriptionData;
 		});
-		billingData.subscriptions.active.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
-		billingData.subscriptions.past.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
-		if (!billingData.subscriptions.primary) billingData.subscriptions.primary = billingData.subscriptions.active[0] ?? billingData.subscriptions.past[0] ?? null;
-		if (billingData.subscriptions.primary) billingData.subscriptions.primary.checkoutUpgradeAuthorization = await this.api.license.retrieveCheckoutUpgradeAuthorization(billingData.subscriptions.primary.licenseId);
-		return billingData;
+		portalSubscriptions.active.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+		portalSubscriptions.past.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+		if (!portalSubscriptions.primary) portalSubscriptions.primary = portalSubscriptions.active[0] ?? portalSubscriptions.past[0] ?? null;
+		if (portalSubscriptions.primary) portalSubscriptions.primary.checkoutUpgradeAuthorization = await this.api.license.retrieveCheckoutUpgradeAuthorization(portalSubscriptions.primary.licenseId);
+		return portalSubscriptions;
 	}
 	/**
-	* @todo - Implement this method to handle actions like get cancel coupon, cancel subscription, update billing, get upgrade auth for Checkout etc.
+	* Check if coupon application is impossible due to certain conditions.
+	* This function can be used to determine if a coupon can be applied to a subscription.
+	* Introduced initially for PayPal subscriptions with a renewal date less than 48 hours in the future.
+	*
+	* @author @DanieleAlessandra
+	* @author @swashata (Ported to SDK)
+	*
+	* @returns boolean
 	*/
-	getPlanTitleById(pricingData) {
-		const planTitles = {};
-		pricingData.plans?.forEach((plan) => {
-			planTitles[plan.id] = plan.title ?? plan.name ?? "Unknown Plan";
-		});
-		return planTitles;
+	isRenewalCancellationCouponApplicable(subscription) {
+		if (subscription.has_subscription_cancellation_discount || (subscription.total_gross ?? 0) <= 0) return false;
+		if (subscription.gateway !== "paypal") return true;
+		const nextPaymentTime = parseDateTime(subscription.next_payment)?.getTime() ?? 0;
+		const currentTime = (/* @__PURE__ */ new Date()).getTime();
+		const fortyEightHoursInMs = 2880 * 60 * 1e3;
+		return nextPaymentTime <= currentTime + fortyEightHoursInMs;
 	}
-	getPricingById(pricingData) {
-		const pricing = {};
-		pricingData.plans?.forEach((plan) => {
-			plan.pricing?.forEach((p) => {
-				pricing[p.id] = p;
-			});
-		});
-		return pricing;
+};
+
+//#endregion
+//#region src/customer-portal/PortalDataRetriever.ts
+var PortalDataRetriever = class {
+	constructor(repository, getUser, endpoint, isSandbox) {
+		this.repository = repository;
+		this.getUser = getUser;
+		this.endpoint = endpoint;
+		this.isSandbox = isSandbox;
+	}
+	createAuthenticatedUrl() {
+		throw new Error("Method not implemented.");
+	}
+	verifyAuthentication() {
+		return true;
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return request.method === "GET" && action === "portal_data";
+	}
+	async processAction() {
+		const user = await this.getUser();
+		if (!user || !("id" in user)) return Response.json(null);
+		return Response.json(await this.repository.retrievePortalDataByUserId({
+			userId: user.id,
+			endpoint: this.endpoint,
+			primaryLicenseId: null,
+			sandbox: this.isSandbox ?? false
+		}));
 	}
 };
 
 //#endregion
-//#region src/models/PurchaseInfo.ts
-var PurchaseInfo = class {
-	email;
-	firstName;
-	lastName;
-	userId;
-	planId;
-	pricingId;
-	licenseId;
-	expiration;
-	canceled;
-	subscriptionId;
-	billingCycle;
-	quota;
-	initialAmount;
-	renewalAmount;
-	currency;
-	renewalDate;
-	paymentMethod;
-	created;
-	constructor(user, license, subscription) {
-		this.email = user.email;
-		this.firstName = user.first ?? "";
-		this.lastName = user.last ?? "";
-		this.userId = idToString(license.user_id);
-		this.canceled = license.is_cancelled ?? false;
-		this.expiration = license.expiration ? parseDateTime(license.expiration) : null;
-		this.licenseId = idToString(license.id);
-		this.planId = idToString(license.plan_id);
-		this.subscriptionId = null;
-		this.billingCycle = null;
-		this.quota = license.quota ?? null;
-		this.pricingId = idToString(license.pricing_id);
-		this.initialAmount = null;
-		this.renewalAmount = null;
-		this.currency = null;
-		this.renewalDate = null;
-		this.paymentMethod = null;
-		this.created = parseDateTime(license.created) ?? /* @__PURE__ */ new Date();
-		if (subscription) {
-			this.subscriptionId = idToString(subscription.id);
-			this.billingCycle = parseBillingCycle(subscription.billing_cycle);
-			this.initialAmount = parseNumber(subscription.initial_amount);
-			this.renewalAmount = parseNumber(subscription.renewal_amount);
-			this.currency = parseCurrency(subscription.currency);
-			this.renewalDate = subscription.next_payment ? parseDateTime(subscription.next_payment) : null;
-			this.paymentMethod = parsePaymentMethod(subscription.gateway);
+//#region src/customer-portal/PurchaseRestorer.ts
+var PurchaseRestorer = class {
+	constructor(purchase, user, callback, subscriptionOnly = false) {
+		this.purchase = purchase;
+		this.user = user;
+		this.callback = callback;
+		this.subscriptionOnly = subscriptionOnly;
+	}
+	createAuthenticatedUrl() {
+		throw new Error("Method not implemented.");
+	}
+	verifyAuthentication() {
+		return true;
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return request.method === "POST" && action === "restore_purchase";
+	}
+	async processAction() {
+		let purchases = null;
+		const user = await this.user();
+		if (!user) throw ActionError.unauthorized("User not authenticated");
+		if (this.subscriptionOnly) purchases = "id" in user ? await this.purchase.retrieveSubscriptions(user.id) : await this.purchase.retrieveSubscriptionsByEmail(user.email);
+		else purchases = "id" in user ? await this.purchase.retrievePurchases(user.id) : await this.purchase.retrievePurchasesByEmail(user.email);
+		if (!purchases) throw ActionError.notFound("No purchases found for the provided user");
+		if (this.callback) {
+			const callbackResponse = await this.callback(purchases);
+			if (callbackResponse) return callbackResponse;
 		}
+		return Response.json(purchases.map((p) => p.toData()));
 	}
-	isPlan(planId) {
-		return this.planId === idToString(planId);
+};
+
+//#endregion
+//#region src/customer-portal/PortalRequestProcessor.ts
+var PortalRequestProcessor = class {
+	constructor(repository, action, purchase) {
+		this.repository = repository;
+		this.action = action;
+		this.purchase = purchase;
 	}
-	isFromPlans(planIds) {
-		return planIds.some((planId) => this.isPlan(planId));
+	createProcessor(config) {
+		return (request) => this.process(config, request);
 	}
-	toData() {
-		return {
-			email: this.email,
-			firstName: this.firstName,
-			lastName: this.lastName,
-			userId: this.userId,
-			planId: this.planId,
-			pricingId: this.pricingId,
-			licenseId: this.licenseId,
-			expiration: this.expiration,
-			canceled: this.canceled,
-			subscriptionId: this.subscriptionId,
-			billingCycle: this.billingCycle,
-			quota: this.quota,
-			isActive: this.isActive,
-			initialAmount: this.initialAmount,
-			renewalAmount: this.renewalAmount,
-			currency: this.currency,
-			renewalDate: this.renewalDate,
-			paymentMethod: this.paymentMethod,
-			created: this.created
-		};
+	/**
+	* Process actions done by the user in the customer portal.
+	*/
+	async process(config, request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		if (!action) return ActionError.badRequest("Action parameter is required").toResponse();
+		const actionHandlers = [new PortalDataRetriever(this.repository, config.getUser, config.portalEndpoint, config.isSandbox), ...this.action.getAllHandlers()];
+		if (config.onRestore) actionHandlers.push(new PurchaseRestorer(this.purchase, config.getUser, config.onRestore, config.restoreSubscriptionsOnly ?? false));
+		try {
+			for (const actionHandler of actionHandlers) if (actionHandler.canHandle(request)) if (actionHandler.verifyAuthentication(request)) return await actionHandler.processAction(request);
+			else throw ActionError.unauthorized("Invalid authentication token");
+		} catch (error) {
+			if (error instanceof ActionError) return error.toResponse();
+			console.error("Error processing action:", error);
+			return ActionError.internalError("Internal Server Error").toResponse();
+		}
+		return ActionError.badRequest("Unsupported action").toResponse();
 	}
-	get isActive() {
-		if (this.canceled) return false;
-		if (this.expiration && this.expiration < /* @__PURE__ */ new Date()) return false;
-		return true;
+};
+
+//#endregion
+//#region src/customer-portal/BillingAction.ts
+const schema$2 = zod.object({
+	business_name: zod.string().optional(),
+	tax_id: zod.string().optional(),
+	phone: zod.string().optional(),
+	address_apt: zod.string().optional(),
+	address_street: zod.string().optional(),
+	address_city: zod.string().optional(),
+	address_state: zod.string().optional(),
+	address_country_code: zod.string().optional(),
+	address_zip: zod.string().optional()
+});
+var BillingAction = class {
+	actionName = "billing";
+	constructor(api, auth) {
+		this.api = api;
+		this.auth = auth;
+	}
+	createAction(id) {
+		return `billing_${id}`;
+	}
+	createAuthenticatedUrl(id, userId, endpoint) {
+		const token = this.auth.createActionToken(this.createAction(id), userId);
+		const url = new URL(endpoint);
+		url.searchParams.set("action", this.actionName);
+		url.searchParams.set("token", token);
+		url.searchParams.set("billingId", id);
+		url.searchParams.set("userId", userId);
+		return url.href;
 	}
-	hasSubscription() {
-		return this.subscriptionId !== null;
+	verifyAuthentication(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		const token = url.searchParams.get("token");
+		const billingId = url.searchParams.get("billingId");
+		const userId = url.searchParams.get("userId");
+		if (!action || !token || !billingId || !userId) return false;
+		return this.auth.verifyActionToken(token, this.createAction(billingId), userId);
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return action === this.actionName;
+	}
+	async processAction(request) {
+		const contentType = request.headers.get("content-type");
+		if (!contentType || !contentType.includes("application/json")) throw ActionError.badRequest("Invalid content type. Expected application/json");
+		let requestBody;
+		try {
+			requestBody = await request.json();
+		} catch {
+			throw ActionError.badRequest("Request body must be valid JSON");
+		}
+		const parseResult = schema$2.safeParse(requestBody);
+		if (!parseResult.success) throw ActionError.validationFailed("Invalid request body format", parseResult.error.issues);
+		const billingData = parseResult.data;
+		const url = new URL(request.url);
+		const billingId = url.searchParams.get("billingId");
+		const userId = url.searchParams.get("userId");
+		if (!billingId) throw ActionError.badRequest("Missing required parameter: billingId");
+		if (!userId) throw ActionError.badRequest("Missing required parameter: userId");
+		const payload = {};
+		if (billingData.business_name) payload.business_name = billingData.business_name;
+		if (billingData.tax_id) payload.tax_id = billingData.tax_id;
+		if (billingData.phone) payload.phone = billingData.phone;
+		if (billingData.address_apt) payload.address_apt = billingData.address_apt;
+		if (billingData.address_street) payload.address_street = billingData.address_street;
+		if (billingData.address_city) payload.address_city = billingData.address_city;
+		if (billingData.address_state) payload.address_state = billingData.address_state;
+		if (billingData.address_country_code) payload.address_country_code = billingData.address_country_code;
+		if (billingData.address_zip) payload.address_zip = billingData.address_zip;
+		const response = await this.api.user.updateBilling(userId, payload);
+		if (!response) throw ActionError.internalError("Failed to update billing information");
+		return Response.json(response, { status: 200 });
 	}
-	isAnnual() {
-		return this.billingCycle === BILLING_CYCLE.YEARLY;
+};
+
+//#endregion
+//#region src/customer-portal/InvoiceAction.ts
+var InvoiceAction = class {
+	actionName = "invoice";
+	constructor(api, auth) {
+		this.api = api;
+		this.auth = auth;
+	}
+	createAction(id) {
+		return `invoice_${id}`;
+	}
+	createAuthenticatedUrl(id, userId, endpoint) {
+		const token = this.auth.createActionToken(this.createAction(id), userId);
+		const url = new URL(endpoint);
+		url.searchParams.set("action", this.actionName);
+		url.searchParams.set("token", token);
+		url.searchParams.set("invoiceId", id);
+		url.searchParams.set("userId", userId);
+		return url.href;
 	}
-	isMonthly() {
-		return this.billingCycle === BILLING_CYCLE.MONTHLY;
+	verifyAuthentication(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		const token = url.searchParams.get("token");
+		const invoiceId = url.searchParams.get("invoiceId");
+		const userId = url.searchParams.get("userId");
+		if (!action || !token || !invoiceId || !userId) return false;
+		return this.auth.verifyActionToken(token, this.createAction(invoiceId), userId);
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return action === this.actionName;
+	}
+	async processAction(request) {
+		const schema$3 = zod.object({
+			invoiceId: zod.string().min(1, "Invoice ID is required"),
+			userId: zod.string().min(1, "User ID is required")
+		});
+		const url = new URL(request.url);
+		const invoiceId = url.searchParams.get("invoiceId");
+		const userIdParam = url.searchParams.get("userId");
+		const parseResult = schema$3.safeParse({
+			invoiceId,
+			userId: userIdParam
+		});
+		if (!parseResult.success) throw ActionError.validationFailed("Invalid request parameters", parseResult.error.issues);
+		const { invoiceId: validInvoiceId } = parseResult.data;
+		try {
+			const pdf = await this.api.payment.retrieveInvoice(validInvoiceId);
+			if (pdf) return new Response(pdf, { headers: {
+				"Content-Type": "application/pdf",
+				"Content-Disposition": `inline; filename="invoice_${validInvoiceId}.pdf"`
+			} });
+			else throw ActionError.notFound("Invoice not found");
+		} catch (error) {
+			if (error instanceof ActionError) throw error;
+			throw ActionError.internalError("Failed to retrieve invoice");
+		}
 	}
-	isOneOff() {
-		return this.billingCycle === BILLING_CYCLE.ONEOFF || this.billingCycle === null;
+};
+
+//#endregion
+//#region src/customer-portal/SubscriptionCancellationAction.ts
+const schema$1 = zod.object({
+	feedback: zod.string().optional(),
+	reason_ids: zod.array(zod.enum([
+		"1",
+		"2",
+		"3",
+		"4",
+		"5",
+		"6",
+		"7",
+		"8",
+		"9",
+		"10",
+		"11",
+		"12",
+		"13",
+		"14",
+		"15"
+	])).optional()
+});
+var SubscriptionCancellationAction = class {
+	actionName = "subscription_cancellation";
+	constructor(api, auth) {
+		this.api = api;
+		this.auth = auth;
+	}
+	createAction(id) {
+		return `cancellation_${id}`;
+	}
+	createAuthenticatedUrl(id, userId, endpoint) {
+		const token = this.auth.createActionToken(this.createAction(id), userId);
+		const url = new URL(endpoint);
+		url.searchParams.set("action", this.actionName);
+		url.searchParams.set("token", token);
+		url.searchParams.set("subscriptionId", id);
+		url.searchParams.set("userId", idToString(userId));
+		return url.href;
 	}
-	getPlanTitle(pricingData) {
-		const plan = pricingData?.plans?.find((p) => isIdsEqual(p.id, this.planId));
-		return plan?.title ?? plan?.name ?? "Deleted Plan";
+	verifyAuthentication(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		const token = url.searchParams.get("token");
+		const subscriptionId = url.searchParams.get("subscriptionId");
+		const userId = url.searchParams.get("userId");
+		if (!action || !token || !subscriptionId || !userId) return false;
+		return this.auth.verifyActionToken(token, this.createAction(subscriptionId), userId);
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return action === this.actionName && request.method === "POST";
+	}
+	async processAction(request) {
+		const contentType = request.headers.get("content-type");
+		if (!contentType || !contentType.includes("application/json")) throw ActionError.badRequest("Invalid content type. Expected application/json");
+		let requestBody;
+		try {
+			requestBody = await request.json();
+		} catch {
+			throw ActionError.badRequest("Request body must be valid JSON");
+		}
+		const parseResult = schema$1.safeParse(requestBody);
+		if (!parseResult.success) throw ActionError.validationFailed("Invalid request body format", parseResult.error.issues);
+		const url = new URL(request.url);
+		const subscriptionId = url.searchParams.get("subscriptionId");
+		const userId = url.searchParams.get("userId");
+		if (!subscriptionId || !userId) throw ActionError.badRequest("Missing subscriptionId or userId");
+		const reasonIds = parseResult.data.reason_ids ? parseResult.data.reason_ids.map((id) => parseInt(id, 10)) : void 0;
+		const result = await this.api.subscription.cancel(subscriptionId, parseResult.data.feedback, reasonIds);
+		if (!result) throw ActionError.internalError("Failed to cancel the subscription");
+		return Response.json(result, { status: 200 });
 	}
 };
 
 //#endregion
-//#region src/services/PurchaseService.ts
-var PurchaseService = class {
-	constructor(api) {
+//#region src/customer-portal/SubscriptionRenewalCouponAction.ts
+const schema = zod.object({ couponId: zod.string().min(1) });
+var SubscriptionRenewalCouponAction = class {
+	actionName = "subscription_cancellation_coupon";
+	constructor(api, auth) {
 		this.api = api;
+		this.auth = auth;
+	}
+	createAction(id) {
+		return `renewal_coupon_${id}`;
+	}
+	createAuthenticatedUrl(id, userId, endpoint) {
+		const token = this.auth.createActionToken(this.createAction(id), userId);
+		const url = new URL(endpoint);
+		url.searchParams.set("action", this.actionName);
+		url.searchParams.set("token", token);
+		url.searchParams.set("subscriptionId", id);
+		url.searchParams.set("userId", idToString(userId));
+		return url.href;
 	}
-	/**
-	* Retrieve purchase information from the Freemius API based on the license ID.
-	*
-	* The license is the primary entitlement for a purchase, and it may or may not be associated with a subscription.
-	* With this method, you can retrieve detailed information about the purchase, including user details, plan, expiration, and more.
-	*/
-	async retrievePurchase(licenseId) {
-		const [license, subscription] = await Promise.all([await this.api.license.retrieve(licenseId), await this.api.license.retrieveSubscription(licenseId)]);
-		if (!license) return null;
-		const user = await this.api.user.retrieve(license.user_id);
-		if (!user) return null;
-		return new PurchaseInfo(user, license, subscription);
+	verifyAuthentication(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		const token = url.searchParams.get("token");
+		const subscriptionId = url.searchParams.get("subscriptionId");
+		const userId = url.searchParams.get("userId");
+		if (!action || !token || !subscriptionId || !userId) return false;
+		return this.auth.verifyActionToken(token, this.createAction(subscriptionId), userId);
+	}
+	canHandle(request) {
+		const url = new URL(request.url);
+		const action = url.searchParams.get("action");
+		return action === this.actionName && request.method === "POST";
+	}
+	async processAction(request) {
+		const contentType = request.headers.get("content-type");
+		if (!contentType || !contentType.includes("application/json")) throw ActionError.badRequest("Invalid content type. Expected application/json");
+		let requestBody;
+		try {
+			requestBody = await request.json();
+		} catch {
+			throw ActionError.badRequest("Request body must be valid JSON");
+		}
+		const parseResult = schema.safeParse(requestBody);
+		if (!parseResult.success) throw ActionError.validationFailed("Invalid request body format", parseResult.error.issues);
+		const url = new URL(request.url);
+		const subscriptionId = url.searchParams.get("subscriptionId");
+		if (!subscriptionId) throw ActionError.badRequest("Missing subscriptionId in the request URL");
+		const result = await this.api.subscription.applyRenewalCoupon(subscriptionId, parseResult.data.couponId, true);
+		if (!result) throw ActionError.internalError("Failed to apply renewal coupon to the subscription");
+		return Response.json(result, { status: 200 });
 	}
-	/**
-	* A helper method to retrieve raw purchase data instead of a full PurchaseInfo object.
-	*
-	* This is useful when passing data from server to client in frameworks like Next.js, where only serializable data should be sent.
-	*/
-	async retrievePurchaseData(licenseId) {
-		const purchaseInfo = await this.retrievePurchase(licenseId);
-		if (!purchaseInfo) return null;
-		return purchaseInfo.toData();
+};
+
+//#endregion
+//#region src/customer-portal/CustomerPortalActionService.ts
+var CustomerPortalActionService = class {
+	invoice;
+	billing;
+	renewalCoupon;
+	cancelRenewal;
+	constructor(api, authService) {
+		this.api = api;
+		this.authService = authService;
+		this.invoice = new InvoiceAction(this.api, this.authService);
+		this.billing = new BillingAction(this.api, this.authService);
+		this.renewalCoupon = new SubscriptionRenewalCouponAction(this.api, this.authService);
+		this.cancelRenewal = new SubscriptionCancellationAction(this.api, this.authService);
+	}
+	getAllHandlers() {
+		return [
+			this.invoice,
+			this.billing,
+			this.renewalCoupon,
+			this.cancelRenewal
+		];
 	}
-	/**
-	* Retrieve a list of active subscriptions for a user. You can use this method to find or sync subscriptions from freemius to your system.
-	*/
-	async retrieveSubscriptions(userId, pagination) {
-		const user = await this.api.user.retrieve(userId);
-		if (!user) return [];
-		const subscriptions = await this.api.user.retrieveSubscriptions(userId, { filter: "active" }, pagination);
-		if (!subscriptions || !subscriptions.length) return [];
-		const licenseSubscriptionPromises = subscriptions.map(async (subscription) => {
-			const license = await this.api.license.retrieve(subscription.license_id);
-			if (!license) return null;
-			return new PurchaseInfo(user, license, subscription);
-		});
-		return await Promise.all(licenseSubscriptionPromises).then((results) => results.filter((result) => result !== null).sort((a, b) => b.created.getTime() - a.created.getTime()));
+};
+
+//#endregion
+//#region src/services/CustomerPortalService.ts
+var CustomerPortalService = class {
+	repository;
+	action;
+	request;
+	constructor(api, checkout, authService, purchase) {
+		this.api = api;
+		this.checkout = checkout;
+		this.authService = authService;
+		this.purchase = purchase;
+		this.action = new CustomerPortalActionService(this.api, this.authService);
+		this.repository = new PortalDataRepository(this.api, this.action, this.checkout);
+		this.request = new PortalRequestProcessor(this.repository, this.action, this.purchase);
 	}
 	/**
-	* Retrieve a list of purchase data for a user.
-	*
-	* This is a convenience method that returns the purchase data in a format suitable for client-side rendering or serialization.
+	* Retrieves the customer portal data for a user, including subscriptions, billing, and payments.
 	*/
-	async retrieveSubscriptionsData(userId, pagination) {
-		const purchaseInfos = await this.retrieveSubscriptions(userId, pagination);
-		return purchaseInfos.map((info) => info.toData());
+	async retrieveData(option) {
+		return this.repository.retrievePortalDataByUserId(option);
 	}
-	async retrieveBySubscription(subscription, subscriptionUser) {
-		if (!subscription.license_id) return null;
-		const license = await this.api.license.retrieve(subscription.license_id);
-		if (!license) return null;
-		const user = subscriptionUser && isIdsEqual(subscriptionUser.id, license.user_id) ? subscriptionUser : await this.api.user.retrieve(license.user_id);
-		if (!user) return null;
-		return new PurchaseInfo(user, license, subscription);
+	async retrieveDataByEmail(option) {
+		return this.repository.retrievePortalDataByEmail(option);
 	}
-	async retrieveActiveSubscriptionByEmail(email, pagination) {
-		const user = await this.api.user.retrieveByEmail(email);
-		if (!user) return null;
-		return await this.retrieveSubscriptions(user.id, pagination);
+	/**
+	* Creates a restorer function that processes an array of purchases by invoking the provided callback for each purchase.
+	*/
+	createRestorer(callback) {
+		return async (purchases) => {
+			await Promise.all(purchases.map((purchase) => callback(purchase)));
+		};
 	}
 };
 
@@ -1224,25 +1869,28 @@ var WebhookListener = class {
 		this.secretKey = secretKey;
 		this.onError = onError;
 	}
-	on(type, handler) {
-		if (!this.eventHandlers.has(type)) this.eventHandlers.set(type, /* @__PURE__ */ new Set());
-		const existingHandlers = this.eventHandlers.get(type);
-		existingHandlers?.add(handler);
-		return this;
-	}
-	off(type, handler) {
-		const currentHandlers = this.eventHandlers.get(type);
-		if (!currentHandlers) return this;
-		currentHandlers.delete(handler);
-		if (currentHandlers.size === 0) this.eventHandlers.delete(type);
+	on(typeOrTypes, handler) {
+		const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];
+		for (const type of types) {
+			if (!this.eventHandlers.has(type)) this.eventHandlers.set(type, /* @__PURE__ */ new Set());
+			const existingHandlers = this.eventHandlers.get(type);
+			existingHandlers?.add(handler);
+		}
 		return this;
 	}
-	onMultiple(handlers) {
-		for (const [type, handler] of Object.entries(handlers)) if (handler) this.on(type, handler);
+	off(typeOrTypes, handler) {
+		const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];
+		for (const type of types) {
+			const currentHandlers = this.eventHandlers.get(type);
+			if (!currentHandlers) continue;
+			currentHandlers.delete(handler);
+			if (currentHandlers.size === 0) this.eventHandlers.delete(type);
+		}
 		return this;
 	}
-	removeAll(type) {
-		this.eventHandlers.delete(type);
+	removeAll(typeOrTypes) {
+		const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];
+		for (const type of types) this.eventHandlers.delete(type);
 		return this;
 	}
 	getHandlerCount(type) {
@@ -1350,6 +1998,9 @@ var WebhookService = class {
 	createListener(onError) {
 		return new WebhookListener(this.secretKey, onError);
 	}
+	createRequestProcessor(listener) {
+		return (request) => this.processFetch(listener, request);
+	}
 	/**
 	* WHATWG Fetch API adapter for modern JavaScript environments.
 	*
@@ -1430,6 +2081,406 @@ var WebhookService = class {
 	}
 };
 
+//#endregion
+//#region src/services/AuthService.ts
+var AuthService = class AuthService {
+	static TOKEN_SEPARATOR = "::";
+	static DEFAULT_EXPIRY_MINUTES = 60;
+	constructor(productId, secretKey) {
+		this.productId = productId;
+		this.secretKey = secretKey;
+		if (!secretKey || secretKey.length < 32) throw new Error("Secret key must be at least 32 characters long");
+	}
+	/**
+	* Creates a secure token for a specific action that can be performed by a user.
+	*
+	* @param action The action identifier (e.g., 'download_invoice', 'update_billing')
+	* @param userId The ID of the user who can perform this action
+	* @param expiryMinutes Optional expiry time in minutes (default: 60 minutes)
+	* @returns A secure token string
+	*/
+	createActionToken(action, userId, expiryMinutes = AuthService.DEFAULT_EXPIRY_MINUTES) {
+		if (!action || action.trim().length === 0) throw new Error("Action cannot be empty");
+		const now = Date.now();
+		const expiresAt = now + expiryMinutes * 60 * 1e3;
+		const nonce = (0, crypto.randomBytes)(16).toString("hex");
+		const payload = this.encodeTokenPayload({
+			expiresAt,
+			nonce
+		});
+		const signature = this.signData(action.trim(), userId, expiresAt, nonce);
+		return `${payload}${AuthService.TOKEN_SEPARATOR}${signature}`;
+	}
+	/**
+	* Verifies and validates an action token.
+	*
+	* @param token The token to verify
+	* @param action The expected action
+	* @param userId The expected user ID
+	* @returns true if valid, false otherwise
+	*/
+	verifyActionToken(token, action, userId) {
+		try {
+			if (!token || typeof token !== "string" || !action || !userId) return false;
+			const parts = token.split(AuthService.TOKEN_SEPARATOR);
+			if (parts.length !== 2) return false;
+			const [payloadPart, signature] = parts;
+			if (!payloadPart || !signature) return false;
+			const payload = this.decodeTokenPayload(payloadPart);
+			if (!payload) return false;
+			const now = Date.now();
+			if (payload.expiresAt <= now) return false;
+			const expectedSignature = this.signData(action.trim(), userId, payload.expiresAt, payload.nonce);
+			return this.constantTimeEqual(signature, expectedSignature);
+		} catch {
+			return false;
+		}
+	}
+	encodeTokenPayload(payload) {
+		const jsonString = JSON.stringify(payload);
+		return Buffer.from(jsonString).toString("base64url");
+	}
+	decodeTokenPayload(payloadPart) {
+		try {
+			const jsonString = Buffer.from(payloadPart, "base64url").toString("utf8");
+			const data = JSON.parse(jsonString);
+			if (typeof data.expiresAt !== "number" || !data.nonce) return null;
+			return data;
+		} catch {
+			return null;
+		}
+	}
+	signData(action, userId, expiresAt, nonce) {
+		const data = `${action}:${idToString(userId)}:${idToString(this.productId)}:${expiresAt}:${nonce}`;
+		return (0, crypto.createHmac)("sha256", this.secretKey).update(data).digest("hex");
+	}
+	constantTimeEqual(a, b) {
+		if (a.length !== b.length) return false;
+		try {
+			return (0, crypto.timingSafeEqual)(Buffer.from(a), Buffer.from(b));
+		} catch {
+			return false;
+		}
+	}
+};
+
+//#endregion
+//#region src/services/PricingService.ts
+var PricingService = class {
+	constructor(api) {
+		this.api = api;
+	}
+	async retrieve(topupPlanId) {
+		const pricingData = await this.api.product.retrievePricingData();
+		const plans = pricingData?.plans?.filter((plan) => {
+			return plan.pricing?.some((p) => this.isValidPricing(p));
+		}).map((plan) => {
+			return {
+				...plan,
+				pricing: plan.pricing?.filter((p) => this.isValidPricing(p)) ?? []
+			};
+		}) ?? [];
+		return {
+			plans,
+			topupPlan: this.findTopupPlan(plans, topupPlanId),
+			sellingUnit: pricingData?.plugin?.selling_unit_label ?? {
+				singular: "Unit",
+				plural: "Units"
+			}
+		};
+	}
+	findTopupPlan(plans, planId) {
+		if (!plans) return null;
+		const topupPlan = plans.find((plan) => {
+			return isIdsEqual(plan.id, planId ?? "") && !plan.is_hidden || plan.pricing?.filter((p) => this.isValidPricing(p)).every((p) => p.lifetime_price);
+		});
+		return topupPlan ?? null;
+	}
+	isValidPricing(pricing) {
+		return !!(pricing.monthly_price || pricing.annual_price || pricing.lifetime_price);
+	}
+};
+
+//#endregion
+//#region src/models/PurchaseInfo.ts
+var PurchaseInfo = class {
+	email;
+	firstName;
+	lastName;
+	userId;
+	planId;
+	pricingId;
+	licenseId;
+	expiration;
+	canceled;
+	subscriptionId;
+	billingCycle;
+	quota;
+	initialAmount;
+	renewalAmount;
+	currency;
+	renewalDate;
+	paymentMethod;
+	created;
+	constructor(user, license, subscription) {
+		this.email = user.email;
+		this.firstName = user.first ?? "";
+		this.lastName = user.last ?? "";
+		this.userId = idToString(license.user_id);
+		this.canceled = license.is_cancelled ?? false;
+		this.expiration = license.expiration ? parseDateTime(license.expiration) : null;
+		this.licenseId = idToString(license.id);
+		this.planId = idToString(license.plan_id);
+		this.subscriptionId = null;
+		this.billingCycle = null;
+		this.quota = license.quota ?? null;
+		this.pricingId = idToString(license.pricing_id);
+		this.initialAmount = null;
+		this.renewalAmount = null;
+		this.currency = null;
+		this.renewalDate = null;
+		this.paymentMethod = null;
+		this.created = parseDateTime(license.created) ?? /* @__PURE__ */ new Date();
+		if (subscription) {
+			this.subscriptionId = idToString(subscription.id);
+			this.billingCycle = parseBillingCycle(subscription.billing_cycle);
+			this.initialAmount = parseNumber(subscription.initial_amount);
+			this.renewalAmount = parseNumber(subscription.renewal_amount);
+			this.currency = parseCurrency(subscription.currency);
+			this.renewalDate = subscription.next_payment ? parseDateTime(subscription.next_payment) : null;
+			this.paymentMethod = parsePaymentMethod(subscription.gateway);
+		}
+	}
+	isPlan(planId) {
+		return this.planId === idToString(planId);
+	}
+	isFromPlans(planIds) {
+		return planIds.some((planId) => this.isPlan(planId));
+	}
+	toData() {
+		return {
+			email: this.email,
+			firstName: this.firstName,
+			lastName: this.lastName,
+			userId: this.userId,
+			planId: this.planId,
+			pricingId: this.pricingId,
+			licenseId: this.licenseId,
+			expiration: this.expiration,
+			canceled: this.canceled,
+			subscriptionId: this.subscriptionId,
+			billingCycle: this.billingCycle,
+			quota: this.quota,
+			isActive: this.isActive,
+			initialAmount: this.initialAmount,
+			renewalAmount: this.renewalAmount,
+			currency: this.currency,
+			renewalDate: this.renewalDate,
+			paymentMethod: this.paymentMethod,
+			created: this.created
+		};
+	}
+	/**
+	* A convenience method to convert the purchase info to a format suitable for database storage.
+	*/
+	toEntitlementRecord(additionalData = {}) {
+		return {
+			...additionalData,
+			fsLicenseId: this.licenseId,
+			fsPlanId: this.planId,
+			fsPricingId: this.pricingId,
+			fsUserId: this.userId,
+			type: this.isSubscription() ? "subscription" : "oneoff",
+			expiration: this.expiration,
+			createdAt: this.created,
+			isCanceled: this.canceled
+		};
+	}
+	get isActive() {
+		if (this.canceled) return false;
+		if (this.expiration && this.expiration < /* @__PURE__ */ new Date()) return false;
+		return true;
+	}
+	isSubscription() {
+		return this.subscriptionId !== null;
+	}
+	isAnnual() {
+		return this.billingCycle === BILLING_CYCLE.YEARLY;
+	}
+	isMonthly() {
+		return this.billingCycle === BILLING_CYCLE.MONTHLY;
+	}
+	isOneOff() {
+		return this.billingCycle === BILLING_CYCLE.ONEOFF || this.billingCycle === null;
+	}
+	getPlanTitle(pricingData) {
+		const plan = pricingData?.plans?.find((p) => isIdsEqual(p.id, this.planId));
+		return plan?.title ?? plan?.name ?? "Deleted Plan";
+	}
+};
+
+//#endregion
+//#region src/services/PurchaseService.ts
+var PurchaseService = class {
+	constructor(api) {
+		this.api = api;
+	}
+	/**
+	* Retrieve purchase information from the Freemius API based on the license ID.
+	*
+	* The license is the primary entitlement for a purchase, and it may or may not be associated with a subscription.
+	* With this method, you can retrieve detailed information about the purchase, including user details, plan, expiration, and more.
+	*/
+	async retrievePurchase(licenseId) {
+		const [license, subscription] = await Promise.all([await this.api.license.retrieve(licenseId), await this.api.license.retrieveSubscription(licenseId)]);
+		if (!license) return null;
+		const user = await this.api.user.retrieve(license.user_id);
+		if (!user) return null;
+		return new PurchaseInfo(user, license, subscription);
+	}
+	/**
+	* A helper method to retrieve raw purchase data instead of a full PurchaseInfo object.
+	*
+	* This is useful when passing data from server to client in frameworks like Next.js, where only serializable data should be sent.
+	*/
+	async retrievePurchaseData(licenseId) {
+		const purchaseInfo = await this.retrievePurchase(licenseId);
+		if (!purchaseInfo) return null;
+		return purchaseInfo.toData();
+	}
+	async retrievePurchases(userOrEntity, pagination) {
+		const user = typeof userOrEntity === "object" ? userOrEntity : await this.api.user.retrieve(userOrEntity);
+		if (!user) return [];
+		const licenses = await this.api.user.retrieveLicenses(user.id, { type: "active" }, pagination);
+		if (!licenses || !licenses.length) return [];
+		const licenseSubscriptionPromises = licenses.map(async (license) => {
+			const subscription = license.expiration !== null ? await this.api.license.retrieveSubscription(license.id) : null;
+			return new PurchaseInfo(user, license, subscription);
+		});
+		return await Promise.all(licenseSubscriptionPromises).then((results) => results.filter((result) => result !== null).sort((a, b) => b.created.getTime() - a.created.getTime()));
+	}
+	async retrievePurchasesData(userOrEntity, pagination) {
+		const purchaseInfos = await this.retrievePurchases(userOrEntity, pagination);
+		return purchaseInfos.map((info) => info.toData());
+	}
+	/**
+	* Retrieve a list of active subscriptions for a user. You can use this method to find or sync subscriptions from freemius to your system.
+	*/
+	async retrieveSubscriptions(userOrEntity, pagination) {
+		const user = typeof userOrEntity === "object" ? userOrEntity : await this.api.user.retrieve(userOrEntity);
+		if (!user) return [];
+		const subscriptions = await this.api.user.retrieveSubscriptions(user.id, { filter: "active" }, pagination);
+		if (!subscriptions || !subscriptions.length) return [];
+		const licenseSubscriptionPromises = subscriptions.map(async (subscription) => {
+			const license = await this.api.license.retrieve(subscription.license_id);
+			if (!license) return null;
+			return new PurchaseInfo(user, license, subscription);
+		});
+		return await Promise.all(licenseSubscriptionPromises).then((results) => results.filter((result) => result !== null).sort((a, b) => b.created.getTime() - a.created.getTime()));
+	}
+	/**
+	* Retrieve a list of purchase data for a user.
+	*
+	* This is a convenience method that returns the purchase data in a format suitable for client-side rendering or serialization.
+	*/
+	async retrieveSubscriptionsData(userId, pagination) {
+		const purchaseInfos = await this.retrieveSubscriptions(userId, pagination);
+		return purchaseInfos.map((info) => info.toData());
+	}
+	async retrieveBySubscription(subscription, subscriptionUser) {
+		if (!subscription.license_id) return null;
+		const license = await this.api.license.retrieve(subscription.license_id);
+		if (!license) return null;
+		const user = subscriptionUser && isIdsEqual(subscriptionUser.id, license.user_id) ? subscriptionUser : await this.api.user.retrieve(license.user_id);
+		if (!user) return null;
+		return new PurchaseInfo(user, license, subscription);
+	}
+	async retrieveSubscriptionsByEmail(email, pagination) {
+		const user = await this.api.user.retrieveByEmail(email);
+		if (!user) return [];
+		return await this.retrieveSubscriptions(user.id, pagination);
+	}
+	async retrievePurchasesByEmail(email, pagination) {
+		const user = await this.api.user.retrieveByEmail(email);
+		if (!user) return [];
+		return await this.retrievePurchases(user.id, pagination);
+	}
+};
+
+//#endregion
+//#region src/services/EntitlementService.ts
+var EntitlementService = class {
+	/**
+	* Get the active subscription entitlement from a list of entitlements stored in your own database.
+	*
+	* @param entitlements - Array of entitlements to filter
+	* @returns The single active entitlement, or null if none found
+	* @throws Error if multiple active entitlements are found
+	*/
+	getActive(entitlements) {
+		const activeEntitlements = this.getActives(entitlements);
+		if (!activeEntitlements || activeEntitlements.length === 0) return null;
+		if (activeEntitlements.length > 1) throw new Error(`Multiple active entitlements found: ${activeEntitlements.length} entitlements are active`);
+		return activeEntitlements[0];
+	}
+	/**
+	* Get all active subscription entitlements from a list of entitlements stored in your own database.
+	*
+	* @param entitlements - Array of entitlements to filter
+	* @returns Array of active entitlements, or null if none found
+	*/
+	getActives(entitlements) {
+		if (!entitlements || entitlements.length === 0) return null;
+		const activeEntitlements = entitlements.filter((entitlement) => {
+			if (entitlement.type !== "subscription") return false;
+			if (entitlement.isCanceled) return false;
+			if (entitlement.expiration === null) return true;
+			const expiration = entitlement.expiration instanceof Date ? entitlement.expiration : parseDateTime(entitlement.expiration);
+			if (expiration && expiration < /* @__PURE__ */ new Date()) return false;
+			return true;
+		});
+		return activeEntitlements.length > 0 ? activeEntitlements : null;
+	}
+	getFsUser(entitlement, email) {
+		if (entitlement) return {
+			email,
+			id: entitlement.fsUserId,
+			primaryLicenseId: entitlement.fsLicenseId
+		};
+		return email ? { email } : null;
+	}
+	/**
+	* Calculates the number of complete months elapsed since the entitlement subscription was created.
+	*
+	* @param entitlement - The entitlement to check
+	* @returns Number of complete months elapsed, or -1 if entitlement is null
+	*/
+	getElapsedMonth(entitlement) {
+		if (!entitlement) return -1;
+		const created = entitlement.createdAt instanceof Date ? entitlement.createdAt : parseDateTime(entitlement.createdAt);
+		if (!created) return -1;
+		const now = /* @__PURE__ */ new Date();
+		let months = (now.getFullYear() - created.getFullYear()) * 12 + (now.getMonth() - created.getMonth());
+		if (now.getDate() < created.getDate()) months -= 1;
+		return months;
+	}
+	/**
+	* Calculates the number of complete years elapsed since the entitlement subscription was created.
+	*
+	* @param entitlement - The entitlement to check
+	* @returns Number of complete years elapsed, or -1 if entitlement is null
+	*/
+	getElapsedYear(entitlement) {
+		if (!entitlement) return -1;
+		const created = entitlement.createdAt instanceof Date ? entitlement.createdAt : parseDateTime(entitlement.createdAt);
+		if (!created) return -1;
+		const now = /* @__PURE__ */ new Date();
+		let years = now.getFullYear() - created.getFullYear();
+		if (now.getMonth() < created.getMonth() || now.getMonth() === created.getMonth() && now.getDate() < created.getDate()) years -= 1;
+		return years;
+	}
+};
+
 //#endregion
 //#region src/Freemius.ts
 var Freemius = class {
@@ -1438,11 +2489,17 @@ var Freemius = class {
 	purchase;
 	customerPortal;
 	webhook;
-	constructor(productId, apiKey, secretKey, publicKey) {
+	pricing;
+	entitlement = new EntitlementService();
+	auth;
+	constructor(config) {
+		const { productId, apiKey, secretKey, publicKey } = config;
 		this.api = new ApiService(productId, apiKey, secretKey, publicKey);
-		this.checkout = new CheckoutService(productId, publicKey, secretKey);
+		this.auth = new AuthService(productId, secretKey);
+		this.pricing = new PricingService(this.api);
 		this.purchase = new PurchaseService(this.api);
-		this.customerPortal = new CustomerPortalService(this.api, this.checkout);
+		this.checkout = new CheckoutService(productId, publicKey, secretKey, this.purchase, this.pricing);
+		this.customerPortal = new CustomerPortalService(this.api, this.checkout, this.auth, this.purchase);
 		this.webhook = new WebhookService(secretKey);
 	}
 };
@@ -1451,7 +2508,6 @@ var Freemius = class {
 exports.BILLING_CYCLE = BILLING_CYCLE;
 exports.CURRENCY = CURRENCY;
 exports.Freemius = Freemius;
-exports.PurchaseInfo = PurchaseInfo;
 exports.idToNumber = idToNumber;
 exports.idToString = idToString;
 exports.isIdsEqual = isIdsEqual;