@freemius/sdk 0.0.6 → 0.2.0

package/dist/index.d.mts

@@ -568,49 +568,6 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  '/developers/{developer_id}/products/{product_id}/emails/{email_id}.json': {
-    parameters: {
-      query?: never;
-      header?: never;
-      path: {
-        /**
-         * @description The ID of the product.
-         * @example 1234
-         */
-        product_id: components['parameters']['product_id'];
-        /**
-         * @description The ID of the developer.
-         * @example 1234
-         */
-        developer_id: components['parameters']['developer_id'];
-        /** @description The ID of the email. */
-        email_id: string;
-      };
-      cookie?: never;
-    };
-    /**
-     * Retrieve an email template
-     * @description Retrieve a specific email template by ID.
-     *     > This is an experimental feature, please don't use it.
-     *
-     *     > Only a developer can access email templates.
-     */
-    get: operations['products/retrieve-email-template'];
-    /**
-     * Update an email template
-     * @description Update a specific email template by ID.
-     *     > This is an experimental feature, please don't use it.
-     *
-     *     > Only a developer can update email templates.
-     */
-    put: operations['products/update-email-template'];
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
   '/products/{product_id}/events/{event_id}.json': {
     parameters: {
       query?: never;
@@ -2561,6 +2518,32 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  '/products/{product_id}/portal/login.json': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /**
+         * @description The ID of the product.
+         * @example 1234
+         */
+        product_id: components['parameters']['product_id'];
+      };
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Generate portal login link
+     * @description Generate a direct login link for a user in the context of the store of the product. The login link is valid for 5 minutes from generation. Either user ID or email must be provided.
+     */
+    post: operations['products/generate-portal-login-link'];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   '/products/{product_id}/pricing.json': {
     parameters: {
       query?: never;
@@ -2775,7 +2758,7 @@ interface paths {
     get: operations['subscriptions/retrieve'];
     /**
      * Update a subscription
-     * @description Update a subscription's auto-renewal status and activate a cancellation coupon.
+     * @description Update a subscription to activate a cancellation coupon.
      */
     put: operations['subscriptions/update'];
     post?: never;
@@ -3381,7 +3364,7 @@ interface paths {
     put?: never;
     /**
      * Create a review
-     * @description Creat a review associated with a license. If you want to create/import reviews which are not associated with a license or from a different system, please use the Review endpoint under `products/{product_id}/reviews.json`.
+     * @description Create a review associated with a license. If you want to create/import reviews which are not associated with a license or from a different system, please use the Review endpoint under `products/{product_id}/reviews.json`.
      */
     post: operations['licenses/create-review'];
     delete?: never;
@@ -4165,30 +4148,6 @@ interface components {
       user_type: 'all' | 'new' | 'current' | 'previous' | 'customer' | 'migrated';
       source?: components['schemas']['Migration']['source'];
     };
-    /** @description Class CouponEnriched */
-    CouponEnriched: components['schemas']['Coupon'] & {
-      /** @description If the discount type is `dollar`, then this field will hold values of absolute discount amount per supported currency. */
-      discounts?: {
-        /**
-         * Format: float
-         * @description The discount amount in absolute value for USD currency.
-         * @example 10.5
-         */
-        usd?: number | null;
-        /**
-         * Format: float
-         * @description The discount amount in absolute value for EUR currency.
-         * @example 10.5
-         */
-        eur?: number | null;
-        /**
-         * Format: float
-         * @description The discount amount in absolute value for GBP currency.
-         * @example 10.5
-         */
-        gbp?: number | null;
-      };
-    };
     /** @description Represents a link between coupons to various special entities. Example: Affiliate coupon tracking, cart abandonment recovery of a product. */
     CouponEntity: {
       id?: components['schemas']['CommonProperties']['id'];
@@ -4222,7 +4181,17 @@ interface components {
       redemptions?: components['schemas']['Coupon']['redemptions'];
       discount?: components['schemas']['Coupon']['discount'];
       discount_type?: components['schemas']['Coupon']['discount_type'];
-      discounts?: components['schemas']['CouponEnriched']['allOf']['1']['discounts'];
+      /**
+       * @description The discount amount for each currency
+       * @example {
+       *       "usd": 10,
+       *       "eur": 9,
+       *       "gbp": 8
+       *     }
+       */
+      discounts?: {
+        [key: string]: number;
+      };
       has_renewals_discount?: components['schemas']['Coupon']['has_renewals_discount'];
     };
     /** @description Class Customer
@@ -5051,9 +5020,18 @@ interface components {
       /** @description Money-back guarantee in days. */
       money_back_period?: number;
       refund_policy?: components['schemas']['CommonEnums']['RefundPolicy'];
+      /** @description Indicates whether the product follows a consumptive usage. Use this if your product includes one-off or consumptive usage like AI credits, API usage etc. It affects how the refund policy is generated for your product. Check our [documentation](https://freemius.com/help/documentation/selling-with-freemius/refund-policy/) to learn more.
+       *
+       *     > This is applicable for SaaS products only. */
+      is_consumptive_usage?: boolean;
       /** @description Renewals discount that will be applied to the chosen plan. */
       annual_renewals_discount?: number | null;
       renewals_discount_type?: components['schemas']['CommonEnums']['RenewalsDiscountType'];
+      /**
+       * @description Number of days to allow proration when upgrading from one lifetime license to another. Can be a number greater than `30` or `null` for unlimited.
+       * @example 30
+       */
+      lifetime_license_proration_days?: number | null;
       /** @description A flag that controls the visibility of add-ons in the in-dashboard add-ons marketplace. Defaults to true. Only applicable if the product is an add-on. */
       is_released?: boolean;
       /** @description A flag that controls whether the SDK should be required or not during deployment of a version. It defaults to `true`. */
@@ -5088,6 +5066,8 @@ interface components {
        */
       earnings?: number;
       type?: components['schemas']['CommonEnums']['ProductType'];
+      /** @description The alias type of the product. For example, 'extension', 'chrome extension', 'desktop app'. */
+      type_alias?: string;
       /** @description Determines whether the product is categorized as a static product (for example, a widget or a template). */
       is_static?: boolean;
     };
@@ -7148,100 +7128,6 @@ interface operations {
       404: components['responses']['404'];
     };
   };
-  'products/retrieve-email-template': {
-    parameters: {
-      query?: {
-        /**
-         * @description Comma separated list of fields to return in the response. If not specified, all fields are returned.
-         * @example id,name,slug
-         */
-        fields?: components['parameters']['fields'];
-      };
-      header?: never;
-      path: {
-        /**
-         * @description The ID of the product.
-         * @example 1234
-         */
-        product_id: components['parameters']['product_id'];
-        /**
-         * @description The ID of the developer.
-         * @example 1234
-         */
-        developer_id: components['parameters']['developer_id'];
-        /** @description The ID of the email. */
-        email_id: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description The email template. */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['EmailTemplate'];
-        };
-      };
-      400: components['responses']['400'];
-      401: components['responses']['401'];
-      402: components['responses']['402'];
-      404: components['responses']['404'];
-    };
-  };
-  'products/update-email-template': {
-    parameters: {
-      query?: {
-        /**
-         * @description Comma separated list of fields to return in the response. If not specified, all fields are returned.
-         * @example id,name,slug
-         */
-        fields?: components['parameters']['fields'];
-      };
-      header?: never;
-      path: {
-        /**
-         * @description The ID of the product.
-         * @example 1234
-         */
-        product_id: components['parameters']['product_id'];
-        /**
-         * @description The ID of the developer.
-         * @example 1234
-         */
-        developer_id: components['parameters']['developer_id'];
-        /** @description The ID of the email. */
-        email_id: string;
-      };
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        'application/json': {
-          subject?: components['schemas']['EmailTemplate']['subject'];
-          html?: components['schemas']['EmailTemplate']['html'];
-          plain?: components['schemas']['EmailTemplate']['plain'];
-        };
-      };
-    };
-    responses: {
-      /** @description The updated email template. */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          'application/json': components['schemas']['EmailTemplate'];
-        };
-      };
-      400: components['responses']['400'];
-      401: components['responses']['401'];
-      402: components['responses']['402'];
-      404: components['responses']['404'];
-    };
-  };
   'events/retrieve': {
     parameters: {
       query?: {
@@ -7570,6 +7456,7 @@ interface operations {
           refund_policy?: components['schemas']['Plugin']['refund_policy'];
           annual_renewals_discount?: components['schemas']['Plugin']['annual_renewals_discount'];
           renewals_discount_type?: components['schemas']['Plugin']['renewals_discount_type'];
+          lifetime_license_proration_days?: components['schemas']['Plugin']['lifetime_license_proration_days'];
           is_pricing_visible?: components['schemas']['Plugin']['is_pricing_visible'];
           default_plan_id?: components['schemas']['Plugin']['default_plan_id'];
           /**
@@ -9283,6 +9170,8 @@ interface operations {
           last_name?: string;
           /** @description Email address of the user (only needed when activating a ghost license). */
           user_email?: string;
+          /** @description Whether to allow license activation if the plans of the product has not been released yet. Useful for testing purpose only. */
+          allow_unreleased_plan_activation?: boolean;
         };
       };
     };
@@ -10750,6 +10639,57 @@ interface operations {
       };
     };
   };
+  'products/generate-portal-login-link': {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /**
+         * @description The ID of the product.
+         * @example 1234
+         */
+        product_id: components['parameters']['product_id'];
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        'application/json': {
+          /**
+           * Format: int64
+           * @description The ID of the user. Either id or email is required.
+           */
+          id?: string;
+          /**
+           * Format: email
+           * @description The email of the user. Either id or email is required.
+           */
+          email?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description Portal login link generated successfully. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          'application/json': {
+            /** @description The generated portal session token. */
+            token?: string;
+            /**
+             * Format: uri
+             * @description The complete portal login URL with the token.
+             */
+            link?: string;
+          };
+        };
+      };
+      400: components['responses']['400'];
+      404: components['responses']['404'];
+    };
+  };
   'products/retrieve-pricing-table-data': {
     parameters: {
       query?: {
@@ -11395,9 +11335,7 @@ interface operations {
     requestBody: {
       content: {
         'application/json': {
-          /** @description Logs an event that confirms the user requested that the subscription will continue to auto-renew. */
-          auto_renew?: boolean;
-          /** @description An optional subscription cancellation coupon ID. The coupon must be set as a special "Cancellation Coupon" in the Freemius Developer Dashboard. If provided the discount will be applied to the next renewals. */
+          /** @description The subscription cancellation coupon ID. The coupon must be set as a special "Cancellation Coupon" in the Freemius Developer Dashboard. The discount will be applied to the next renewals. */
           coupon_id?: number;
         };
       };
@@ -12336,7 +12274,7 @@ interface operations {
           send_verification_email?: boolean;
           is_marketing_allowed?: components['schemas']['User']['is_marketing_allowed'];
           /** @description (optional) If `true`, no emails will be sent to users nor events will be logged. */
-          is_migration?: string;
+          is_migration?: boolean;
           source?: components['schemas']['Migration']['source_external_id'];
         };
       };
@@ -12924,6 +12862,7 @@ type UserSubscriptionFilterOptions = ApiEntitiesFilter<operations['users/list-su
 type UserLicenseFilterOptions = ApiEntitiesFilter<operations['users/list-licenses']['parameters']['query']>;
 type UserPaymentFilterOptions = ApiEntitiesFilter<operations['users/list-payments']['parameters']['query']>;
 type UserPluginEntity = components['schemas']['UserPluginEnriched'];
+type UserCustomerPortalResult = operations['products/generate-portal-login-link']['responses'][201]['content']['application/json'];
 type LicenseEntity = components['schemas']['License'];
 type LicenseFilterOptions = ApiEntitiesFilter<operations['licenses/list']['parameters']['query']>;
 type PaymentEntity = components['schemas']['Payment'];
@@ -12935,6 +12874,7 @@ type PlanEntity = components['schemas']['Plan'];
 type BillingEntity = components['schemas']['Billing'];
 type BillingUpdatePayload = operations['users/update-or-create-billing']['requestBody']['content']['application/json'];
 type EventEntity = components['schemas']['EventLog'];
+type EventFilterOptions = ApiEntitiesFilter<operations['events/list']['parameters']['query']>;
 type InstallEntity = components['schemas']['Install'];
 type BillingCycleApiEnum = components['schemas']['CommonEnums']['BillingCycle'];
 type CurrencyApiEnum = components['schemas']['CommonEnums']['Currency'];
@@ -13195,9 +13135,9 @@ interface CheckoutRedirectData {
    */
   pricing_id: string;
   /**
-   * Currency of the purchase (ISO code).
+   * Indicates the type of action performed during checkout.
    */
-  currency: CURRENCY;
+  action: 'payment_method_update' | 'license_update' | 'trial' | 'purchase';
   /**
    * ID of the Freemius license, if available.
    */
@@ -13211,12 +13151,17 @@ interface CheckoutRedirectData {
    */
   quota: number | null;
   /**
-   * Indicates the type of action performed during checkout, if applicable.
-   * Can be 'payment_method_update' or 'license_update'.
-   *
-   * If null it means the checkout was a standard purchase.
+   * Indicates if the trial is free or paid. Null if not a trial.
    */
-  action: 'payment_method_update' | 'license_update' | null;
+  trial: 'free' | 'paid' | null;
+  /**
+   * End date of the trial period, if applicable.
+   */
+  trial_ends_at: Date | null;
+  /**
+   * Currency of the purchase (ISO code).
+   */
+  currency: CURRENCY;
   /**
    * Total amount charged for the purchase.
    */
@@ -13225,18 +13170,6 @@ interface CheckoutRedirectData {
    * Tax amount applied to the purchase.
    */
   tax: number;
-  /**
-   * Indicates a subscription purchase.
-   * If present, the following fields are required:
-   * - type: 'subscription'
-   * - subscription_id
-   * - billing_cycle
-   *
-   * If not present, the purchase is a one-off and the following fields are required:
-   * - type: 'one-off'
-   * - payment_id
-   */
-  type: 'subscription' | 'one-off';
   /**
    * ID of the Freemius subscription associated with the license (for subscriptions only).
    */
@@ -13249,6 +13182,20 @@ interface CheckoutRedirectData {
    * ID of the payment for the one-off purchase (for one-off only).
    */
   payment_id: string | null;
+  /**
+   * Indicates a subscription purchase.
+   * If present, the following fields are required:
+   * - type: 'subscription'
+   * - subscription_id
+   * - billing_cycle
+   *
+   * If not present, the purchase is a one-off and the following fields are required:
+   * - type: 'one-off'
+   * - payment_id
+   *
+   * If null, indicates this is a free trial purchase and the final type of purchase is not applicable.
+   */
+  type: 'subscription' | 'one-off' | null;
 }
 type CheckoutBuilderUserOptions = {
   email: string;
@@ -13301,6 +13248,12 @@ type CheckoutBuilderOptions = {
    * If not provided, the checkout will not have a trial period.
    */
   trial?: CheckoutOptions['trial'];
+  /**
+   * Optional license ID for license upgrade scenarios.
+   *
+   * When provided, the checkout will be configured for upgrading the specified license. Use this to generate upgrade links for existing users.
+   */
+  licenseId?: string;
 };
 /**
  * Interface for actions that can be processed during the checkout flow.
@@ -13332,6 +13285,20 @@ type PricingData = {
   sellingUnit: SellingUnit;
 };
 //#endregion
+//#region src/contracts/webhook.d.ts
+type WebhookListenerResponse = {
+  status: number;
+} & ({
+  success: true;
+} | {
+  success: false;
+  error: string;
+});
+declare enum WebhookAuthenticationMethod {
+  SignatureHeader = "SignatureHeader",
+  Api = "Api",
+}
+//#endregion
 //#region src/api/parser.d.ts
 declare function idToNumber(id: FSId): number;
 declare function idToString(id: FSId): string;
@@ -13343,6 +13310,26 @@ declare function parseDate(dateString?: string | null): Date | null;
 declare function parseCurrency(currency?: CurrencyApiEnum): CURRENCY | null;
 declare function parsePaymentMethod(gateway?: string | null): PaymentMethod | null;
 //#endregion
+//#region src/errors/ActionError.d.ts
+declare class ActionError extends Error {
+  readonly statusCode: number;
+  readonly validationIssues?: unknown;
+  constructor(message: string, statusCode?: number, validationIssues?: unknown);
+  toResponse(): Response;
+  static badRequest(message: string): ActionError;
+  static unauthorized(message?: string): ActionError;
+  static notFound(message?: string): ActionError;
+  static validationFailed(message: string, validationIssues: unknown): ActionError;
+  static internalError(message?: string): ActionError;
+}
+//#endregion
+//#region src/errors/WebhookError.d.ts
+declare class WebhookError extends Error {
+  readonly statusCode: number;
+  constructor(message: string, statusCode?: number);
+  toResponse(): WebhookListenerResponse;
+}
+//#endregion
 //#region src/api/client.d.ts
 declare function createApiClient(baseUrl: string, bearerToken?: string): createClient.Client<paths, `${string}/${string}`>;
 type FsApiClient = ReturnType<typeof createApiClient>;
@@ -13575,6 +13562,8 @@ declare class User extends ApiBase<UserEntity, UserFilterOptions> {
   retrieveLicenses(userId: FSId, filters?: UserLicenseFilterOptions, pagination?: PagingOptions): Promise<LicenseEntity[]>;
   retrievePayments(userId: FSId, filters?: UserPaymentFilterOptions, pagination?: PagingOptions): Promise<PaymentEntity[]>;
   updateBilling(userId: FSId, payload: BillingUpdatePayload): Promise<UserBillingEntity | null>;
+  retrieveHostedCustomerPortal(userId: FSId): Promise<UserCustomerPortalResult | null>;
+  retrieveHostedCustomerPortalByEmail(email: string): Promise<UserCustomerPortalResult | null>;
 }
 //#endregion
 //#region src/api/Payment.d.ts
@@ -13619,6 +13608,48 @@ declare class Payment extends ApiBase<PaymentEntity, PaymentFilterOptions> {
   retrieveInvoice(paymentId: FSId): Promise<Blob | null>;
 }
 //#endregion
+//#region src/api/WebhookEvent.d.ts
+declare class WebhookEvent$1 extends ApiBase<EventEntity, EventFilterOptions> {
+  retrieve(eventId: FSId): Promise<({
+    state?: components["schemas"]["CommonEnums"]["EventLogState"];
+    id?: components["schemas"]["CommonProperties"]["id"];
+    created?: components["schemas"]["CommonProperties"]["created"];
+    updated?: components["schemas"]["CommonProperties"]["updated"];
+    type?: string;
+    developer_id?: string;
+    plugin_id?: components["schemas"]["CommonProperties"]["plugin_id_nullable"];
+    user_id?: components["schemas"]["CommonProperties"]["user_id_nullable"];
+    install_id?: components["schemas"]["CommonProperties"]["install_id_nullable"];
+    data?: unknown;
+    event_trigger?: "system" | "developer" | "plugin" | "user" | "install";
+    process_time?: string | null;
+  } & {
+    objects?: {
+      user?: components["schemas"]["UserPluginEnriched"] | null;
+      install?: components["schemas"]["Install"] | null;
+      payment?: components["schemas"]["Payment"] | null;
+      subscription?: components["schemas"]["Subscription"] | null;
+      license?: components["schemas"]["License"] | null;
+    } & {
+      [key: string]: unknown;
+    };
+  }) | null>;
+  retrieveMany(filter?: EventFilterOptions, pagination?: PagingOptions): Promise<{
+    state?: components["schemas"]["CommonEnums"]["EventLogState"];
+    id?: components["schemas"]["CommonProperties"]["id"];
+    created?: components["schemas"]["CommonProperties"]["created"];
+    updated?: components["schemas"]["CommonProperties"]["updated"];
+    type?: string;
+    developer_id?: string;
+    plugin_id?: components["schemas"]["CommonProperties"]["plugin_id_nullable"];
+    user_id?: components["schemas"]["CommonProperties"]["user_id_nullable"];
+    install_id?: components["schemas"]["CommonProperties"]["install_id_nullable"];
+    data?: unknown;
+    event_trigger?: "system" | "developer" | "plugin" | "user" | "install";
+    process_time?: string | null;
+  }[]>;
+}
+//#endregion
 //#region src/services/ApiService.d.ts
 /**
  * @todo - Add a proper user-agent string with SDK version.
@@ -13633,6 +13664,7 @@ declare class ApiService {
   readonly product: Product;
   readonly subscription: Subscription;
   readonly payment: Payment;
+  readonly event: WebhookEvent$1;
   readonly baseUrl: string;
   constructor(productId: FSId, apiKey: string, secretKey: string, publicKey: string);
   /**
@@ -13668,6 +13700,10 @@ type CheckoutSerialized = {
   link: string;
   baseUrl: string;
 };
+type CheckoutLicenseAuthorization = {
+  licenseId: FSId;
+  authorization: string;
+};
 /**
  * A builder class for constructing checkout parameters. This class provides a fluent
  * API to create Checkout parameters for a product with various configurations.
@@ -13679,43 +13715,37 @@ declare class Checkout {
   private readonly productId;
   private readonly publicKey;
   private readonly secretKey;
-  static createSandboxToken(productId: string, secretKey: string, publicKey: string): NonNullable<CheckoutPopupParams['sandbox']>;
   private options;
   constructor(productId: string, publicKey: string, secretKey: string);
   /**
    * Enables sandbox mode for testing purposes.
    *
-   * @returns A new builder instance with sandbox configuration
    */
-  setSandbox(): Checkout;
+  setSandbox(sandbox: NonNullable<CheckoutPopupParams['sandbox']>): Checkout;
   /**
    * Sets user information for the checkout session.
    *
    * @param user User object with email and optional name fields. The shape matches the session from `better-auth` or next-auth packages. Also handles `null` or `undefined` gracefully.
    * @param readonly If true, the user information will be read-only in the checkout session.
    *
-   * @returns A new builder instance with user configuration
    */
   setUser(user: CheckoutBuilderUserOptions, readonly?: boolean): Checkout;
   /**
    * Applies recommended UI settings for better user experience.
    * This includes fullscreen mode, upsells, refund badge, and reviews display.
    *
-   * @returns A new builder instance with recommended UI settings
    */
   setRecommendations(): Checkout;
   /**
    * Sets the plan ID for the checkout.
    *
    * @param planId The plan ID to purchase
-   * @returns A new builder instance with plan ID set
    */
   setPlan(planId: string | number): Checkout;
   /**
    * Sets the number of licenses to purchase.
    *
    * @param count Number of licenses
-   * @returns A new builder instance with license count set
    */
   setQuota(count: number): Checkout;
   setPricing(pricingId: string | number): Checkout;
@@ -13725,7 +13755,6 @@ declare class Checkout {
    *
    * @param coupon The coupon code to apply
    * @param hideUI Whether to hide the coupon input field from users
-   * @returns A new builder instance with coupon configuration
    */
   setCoupon(options: {
     code: string;
@@ -13735,14 +13764,12 @@ declare class Checkout {
    * Enables trial mode for the checkout.
    *
    * @param mode Trial type - true/false for plan default, or specific 'free'/'paid' mode
-   * @returns A new builder instance with trial configuration
    */
   setTrial(mode?: 'free' | 'paid' | boolean): Checkout;
   /**
    * Configures the visual layout and appearance of the checkout.
    *
    * @param options Appearance configuration options
-   * @returns A new builder instance with appearance configuration
    */
   setAppearance(options: {
     layout?: 'vertical' | 'horizontal' | null;
@@ -13755,7 +13782,6 @@ declare class Checkout {
    * Configures discount display settings.
    *
    * @param options Discount configuration options
-   * @returns A new builder instance with discount configuration
    */
   setDiscounts(options: {
     annual?: boolean;
@@ -13768,21 +13794,18 @@ declare class Checkout {
    *
    * @param selector Type of billing cycle selector to show
    * @param defaultCycle Default billing cycle to select
-   * @returns A new builder instance with billing cycle configuration
    */
   setBillingCycle(defaultCycle: 'monthly' | 'annual' | 'lifetime', selector?: 'list' | 'responsive_list' | 'dropdown'): Checkout;
   /**
    * Sets the language/locale for the checkout.
    *
    * @param locale Language setting - 'auto', 'auto-beta', or specific locale like 'en_US'
-   * @returns A new builder instance with locale configuration
    */
   setLanguage(locale?: 'auto' | 'auto-beta' | string): Checkout;
   /**
    * Configures review and badge display settings.
    *
    * @param options Review and badge configuration
-   * @returns A new builder instance with reviews and badges configuration
    */
   setSocialProofing(options: {
     showReviews?: boolean;
@@ -13796,7 +13819,6 @@ declare class Checkout {
    * @param currency Primary currency or 'auto' for automatic detection
    * @param defaultCurrency Default currency when using 'auto'
    * @param showInlineSelector Whether to show inline currency selector
-   * @returns A new builder instance with currency configuration
    */
   setCurrency(currency: 'usd' | 'eur' | 'gbp' | 'auto', defaultCurrency?: 'usd' | 'eur' | 'gbp', showInlineSelector?: boolean): Checkout;
   /**
@@ -13804,42 +13826,42 @@ declare class Checkout {
    *
    * @param cancelUrl URL for back button when in page mode
    * @param cancelIcon Custom cancel icon URL
-   * @returns A new builder instance with navigation configuration
    */
   setCancelButton(cancelUrl?: string, cancelIcon?: string): Checkout;
   /**
    * Associates purchases with an affiliate account.
    *
    * @param userId Affiliate user ID
-   * @returns A new builder instance with affiliate configuration
    */
   setAffiliate(userId: number): Checkout;
   /**
    * Sets a custom image/icon for the checkout.
    *
    * @param imageUrl Secure HTTPS URL to the image
-   * @returns A new builder instance with custom image
    */
   setImage(imageUrl: string): Checkout;
   /**
-   * Configures the checkout for license renewal.
+   * Configures the checkout for license renewal or upgrade by the license key.
+   *
+   * @note - This is less secure since it exposes the license key to the client. Use only in authenticated contexts.
    *
    * @param licenseKey The license key to renew
-   * @returns A new builder instance configured for renewal
    */
-  setLicenseRenewal(licenseKey: string): Checkout;
+  setLicenseUpgradeByKey(licenseKey: string): Checkout;
   /**
-   * Builds and returns the final checkout options to be used with the `@freemius/checkout` package.
+   * Configures the checkout for license upgrade using an authorization token.
    *
-   * @note - This is async by purpose so that we can allow for future enhancements that might require async operations.
+   * @param params The license upgrade authorization parameters
+   */
+  setLicenseUpgradeByAuth(params: CheckoutLicenseAuthorization): Checkout;
+  /**
+   * Builds and returns the final checkout options to be used with the `@freemius/checkout` package.
    *
    * @returns The constructed CheckoutOptions object
    */
   getOptions(): CheckoutOptions;
   /**
    * 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(): string;
   serialize(): CheckoutSerialized;
@@ -13949,14 +13971,16 @@ declare class CheckoutRedirectInfo implements CheckoutRedirectData {
   plan_id: string;
   email: string;
   pricing_id: string;
-  currency: CURRENCY;
+  action: 'payment_method_update' | 'license_update' | 'trial' | 'purchase';
   license_id: string;
   expiration: Date | null;
   quota: number | null;
-  action: 'payment_method_update' | 'license_update' | null;
+  trial: 'free' | 'paid' | null;
+  trial_ends_at: Date | null;
+  currency: CURRENCY;
   amount: number;
   tax: number;
-  type: 'subscription' | 'one-off';
+  type: 'subscription' | 'one-off' | null;
   subscription_id: string | null;
   billing_cycle: BILLING_CYCLE | null;
   payment_id: string | null;
@@ -14047,13 +14071,14 @@ declare class CheckoutRequestProcessor implements RequestProcessor<CheckoutReque
 //#endregion
 //#region src/services/CheckoutService.d.ts
 declare class CheckoutService {
+  private readonly api;
   private readonly productId;
   private readonly publicKey;
   private readonly secretKey;
   private readonly purchase;
   private readonly pricing;
   readonly request: CheckoutRequestProcessor;
-  constructor(productId: FSId, publicKey: string, secretKey: string, purchase: PurchaseService, pricing: PricingService);
+  constructor(api: ApiService, productId: FSId, publicKey: string, secretKey: string, purchase: PurchaseService, pricing: PricingService);
   /**
    * Use this to build a Checkout for your product.
    * You can build a Checkout link or options for the popup.
@@ -14093,11 +14118,14 @@ declare class CheckoutService {
    * This shouldn't be used in production, but is useful for testing purposes.
    *
    * @note This is intentionally set as `async` because we would use the API in the future to generate more fine grained sandbox params (for example for a specific email address only).
-   *
-   * @todo - This has a duplication with the `inSandbox` method in the builder. Consider refactoring to avoid this duplication.
-   *         Also think about whether we should make the builder's `inSandbox` method async as well.
    */
   getSandboxParams(): Promise<NonNullable<CheckoutPopupParams['sandbox']>>;
+  /**
+   * Retrieves the license upgrade authorization for a given license ID.
+   *
+   * This is used to authorize a license upgrade during the checkout process. Useful when creating upgrade links for existing users.
+   */
+  getLicenseUpgradeAuth(licenseId: FSId): Promise<CheckoutLicenseAuthorization>;
   /**
    * Processes a redirect URL and returns the checkout redirect information if valid.
    *
@@ -14600,19 +14628,13 @@ interface NormalizedRequest {
   headers: Record<string, string | string[] | undefined> | Headers;
   rawBody: string | Buffer;
 }
-type WebhookListenerResponse = {
-  status: number;
-} & ({
-  success: true;
-} | {
-  success: false;
-  error: string;
-});
 declare class WebhookListener {
+  private readonly api;
   private readonly secretKey;
   private readonly onError;
+  private readonly authenticationMethod;
   private eventHandlers;
-  constructor(secretKey: string, onError?: (error: unknown) => void);
+  constructor(api: ApiService, secretKey: string, onError?: (error: unknown) => Promise<void>, authenticationMethod?: WebhookAuthenticationMethod);
   on<T extends WebhookEventType>(type: T, handler: WebhookEventHandler<T>): this;
   on<T extends WebhookEventType>(types: T[], handler: WebhookEventHandler<T>): this;
   off<T extends WebhookEventType>(type: T, handler: WebhookEventHandler<T>): this;
@@ -14634,14 +14656,23 @@ declare class WebhookListener {
    * Returns an object you can map to your framework's response easily.
    */
   process(input: NormalizedRequest): Promise<WebhookListenerResponse>;
+  private authenticateAndGetEventFromInput;
+  private authenticateAndGetEventFromApi;
+  private parseEventFromInput;
+  private processEvent;
   private getHeader;
 }
 //#endregion
 //#region src/services/WebhookService.d.ts
+type WebhookListenerConfig = {
+  onError?: (error: unknown) => Promise<void>;
+  authenticationMethod?: WebhookAuthenticationMethod;
+};
 declare class WebhookService {
+  private readonly api;
   private readonly secretKey;
-  constructor(secretKey: string);
-  createListener(onError?: (error: unknown) => void): WebhookListener;
+  constructor(api: ApiService, secretKey: string);
+  createListener(config?: WebhookListenerConfig): WebhookListener;
   createRequestProcessor(listener: WebhookListener): (request: Request) => Promise<Response>;
   /**
    * WHATWG Fetch API adapter for modern JavaScript environments.
@@ -14755,5 +14786,5 @@ declare class Freemius {
   constructor(config: FreemiusConfig);
 }
 //#endregion
-export { ApiAuthParams, ApiEntitiesFilter, type ApiService, type ApplyRenewalCouponRequest, BILLING_CYCLE, BillingCycleApiEnum, BillingEntity, type BillingRequest, BillingUpdatePayload, CURRENCY, type Checkout, CheckoutAction, type CheckoutRequestConfig as CheckoutActionConfig, CheckoutBuilderOptions, CheckoutBuilderUserOptions, CheckoutRedirectData, type CheckoutRedirectInfo, type CheckoutSerialized, type CheckoutService, CouponEntityEnriched, CurrencyApiEnum, type CustomerPortalDataWithEmailOption, type CustomerPortalDataWithUserOption, type CustomerPortalService, EventEntity, FSId, Freemius, FreemiusConfig, InstallEntity, LicenseEntity, LicenseFilterOptions, PagingOptions, PaymentEntity, PaymentFilterOptions, PaymentMethod, PlanEntity, PortalAction, PortalBilling, PortalData, PortalPayment, PortalPlans, type PortalRequestConfig, PortalSubscription, PortalSubscriptions, PricingData, PricingEntity, type PricingService, PricingTableData, ProductEntity, PurchaseData, PurchaseEntitlementData, PurchaseEntitlementType, type PurchaseInfo, type PurchaseService, RequestProcessor, SellingUnit, SubscriptionCancellationReasonType, type SubscriptionCancellationRequest, SubscriptionCancellationResult, SubscriptionDiscountEntity, SubscriptionEntity, SubscriptionFilterOptions, SubscriptionRenewalCouponResult, UserBillingEntity, UserEntity, UserFilterOptions, UserLicenseFilterOptions, UserPaymentFilterOptions, UserPluginEntity, UserRetriever, UserSubscriptionEntity, UserSubscriptionFilterOptions, UserSubscriptionWithDiscounts, type WebhookEvent, type WebhookEventDataMap, type WebhookEventHandler, type WebhookEventType, type WebhookService, idToNumber, idToString, isIdsEqual, parseBillingCycle, parseCurrency, parseDate, parseDateTime, parseNumber, parsePaymentMethod };
+export { ActionError, ApiAuthParams, ApiEntitiesFilter, type ApiService, type ApplyRenewalCouponRequest, BILLING_CYCLE, BillingCycleApiEnum, BillingEntity, type BillingRequest, BillingUpdatePayload, CURRENCY, type Checkout, CheckoutAction, type CheckoutRequestConfig as CheckoutActionConfig, CheckoutBuilderOptions, CheckoutBuilderUserOptions, CheckoutRedirectData, type CheckoutRedirectInfo, type CheckoutSerialized, type CheckoutService, CouponEntityEnriched, CurrencyApiEnum, type CustomerPortalDataWithEmailOption, type CustomerPortalDataWithUserOption, type CustomerPortalService, EventEntity, EventFilterOptions, FSId, Freemius, FreemiusConfig, InstallEntity, LicenseEntity, LicenseFilterOptions, PagingOptions, PaymentEntity, PaymentFilterOptions, PaymentMethod, PlanEntity, PortalAction, PortalBilling, PortalData, PortalPayment, PortalPlans, type PortalRequestConfig, PortalSubscription, PortalSubscriptions, PricingData, PricingEntity, type PricingService, PricingTableData, ProductEntity, PurchaseData, PurchaseEntitlementData, PurchaseEntitlementType, type PurchaseInfo, type PurchaseService, RequestProcessor, SellingUnit, SubscriptionCancellationReasonType, type SubscriptionCancellationRequest, SubscriptionCancellationResult, SubscriptionDiscountEntity, SubscriptionEntity, SubscriptionFilterOptions, SubscriptionRenewalCouponResult, UserBillingEntity, UserCustomerPortalResult, UserEntity, UserFilterOptions, UserLicenseFilterOptions, UserPaymentFilterOptions, UserPluginEntity, UserRetriever, UserSubscriptionEntity, UserSubscriptionFilterOptions, UserSubscriptionWithDiscounts, WebhookAuthenticationMethod, WebhookError, type WebhookEvent, type WebhookEventDataMap, type WebhookEventHandler, type WebhookEventType, WebhookListenerResponse, type WebhookService, idToNumber, idToString, isIdsEqual, parseBillingCycle, parseCurrency, parseDate, parseDateTime, parseNumber, parsePaymentMethod };
 //# sourceMappingURL=index.d.mts.map