@polar-sh/sdk 1.0.0 → 1.0.2

package/dist/{models-DjSYF7EH.d.cts → models-P8aaHkKR.d.cts}

@@ -214,7 +214,7 @@ type PaymentStatus = "pending" | "succeeded" | "failed";
  */
 type PaymentTrigger = "purchase" | "subscription_cycle" | "retry_dunning" | "retry_customer" | "retry_payment_method_update" | "retry_admin";
 /**
- * The permission level to grant. Read more about roles and their permissions on [GitHub documentation](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#permissions-for-each-role).
+ * Permission
  */
 type Permission = "pull" | "triage" | "push" | "maintain" | "admin";
 /**
@@ -1275,7 +1275,7 @@ interface BenefitCustom {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -1586,7 +1586,7 @@ interface BenefitDiscord {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -1927,7 +1927,7 @@ interface BenefitDownloadables {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -2182,7 +2182,7 @@ interface BenefitFeatureFlag {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -2417,7 +2417,7 @@ interface BenefitGitHubRepository {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -3634,7 +3634,7 @@ interface BenefitLicenseKeys {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -3920,7 +3920,7 @@ interface BenefitMeterCredit {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -4272,7 +4272,7 @@ interface BenefitSlackSharedChannel {
    */
   metadata: MetadataOutputType;
   /**
-   * visibility
+   * The visibility of the benefit in the customer portal.
    */
   visibility: BenefitVisibility;
   /**
@@ -4535,7 +4535,7 @@ interface BenefitSubscriberOrganization {
    */
   avatar_url: string | null;
   /**
-   * proration_behavior
+   * Proration behavior applied when customer updates their subscription from the portal.
    */
   proration_behavior: SubscriptionProrationBehavior;
   /**
@@ -4634,11 +4634,11 @@ interface CardPayment {
    */
   id: string;
   /**
-   * processor
+   * The payment processor.
    */
   processor: PaymentProcessor;
   /**
-   * status
+   * The payment status.
    */
   status: PaymentStatus;
   /**
@@ -4682,7 +4682,7 @@ interface CardPayment {
    */
   processor_metadata?: Record<string, unknown>;
   /**
-   * method_metadata
+   * Additional metadata for the card payment method.
    */
   method_metadata: CardPaymentMetadata;
 }
@@ -4720,12 +4720,20 @@ interface Checkout {
    */
   custom_field_data?: Record<string, string | number | boolean | null>;
   /**
-   * payment_processor
+   * Payment processor used.
    */
   payment_processor: PaymentProcessor;
   /**
-   * status
-   */
+     *
+          Status of the checkout session.
+  
+          - Open: the checkout session was opened.
+          - Expired: the checkout session was expired and is no more accessible.
+          - Confirmed: the user on the checkout session clicked Pay. This is not indicative of the payment's success status.
+          - Failed: the checkout definitely failed for technical reasons and cannot be retried. In most cases, this state is never reached.
+          - Succeeded: the payment on the checkout was performed successfully.
+          
+     */
   status: CheckoutStatus;
   /**
    * Client secret used to update and complete the checkout session from the client.
@@ -4908,7 +4916,7 @@ interface Checkout {
    */
   payment_processor_metadata: Record<string, string>;
   /**
-   * billing_address_fields
+   * Determine which billing address fields should be disabled, optional or required in the checkout form.
    */
   billing_address_fields: CheckoutBillingAddressFields;
   /**
@@ -5472,7 +5480,7 @@ interface CheckoutLink {
    */
   metadata: MetadataOutputType;
   /**
-   * payment_processor
+   * Payment processor used.
    */
   payment_processor: PaymentProcessor;
   /**
@@ -5768,7 +5776,7 @@ interface CheckoutLinkProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -5917,7 +5925,7 @@ interface CheckoutOrganization {
    */
   avatar_url: string | null;
   /**
-   * proration_behavior
+   * Proration behavior applied when customer updates their subscription from the portal.
    */
   proration_behavior: SubscriptionProrationBehavior;
   /**
@@ -5958,7 +5966,7 @@ interface CheckoutProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -6023,12 +6031,20 @@ interface CheckoutPublic {
    */
   custom_field_data?: Record<string, string | number | boolean | null>;
   /**
-   * payment_processor
+   * Payment processor used.
    */
   payment_processor: PaymentProcessor;
   /**
-   * status
-   */
+     *
+          Status of the checkout session.
+  
+          - Open: the checkout session was opened.
+          - Expired: the checkout session was expired and is no more accessible.
+          - Confirmed: the user on the checkout session clicked Pay. This is not indicative of the payment's success status.
+          - Failed: the checkout definitely failed for technical reasons and cannot be retried. In most cases, this state is never reached.
+          - Succeeded: the payment on the checkout was performed successfully.
+          
+     */
   status: CheckoutStatus;
   /**
    * Client secret used to update and complete the checkout session from the client.
@@ -6211,7 +6227,7 @@ interface CheckoutPublic {
    */
   payment_processor_metadata: Record<string, string>;
   /**
-   * billing_address_fields
+   * Determine which billing address fields should be disabled, optional or required in the checkout form.
    */
   billing_address_fields: CheckoutBillingAddressFields;
   /**
@@ -6267,7 +6283,7 @@ interface CheckoutPublicConfirmed {
    */
   custom_field_data?: Record<string, string | number | boolean | null>;
   /**
-   * payment_processor
+   * Payment processor used.
    */
   payment_processor: PaymentProcessor;
   /**
@@ -6455,7 +6471,7 @@ interface CheckoutPublicConfirmed {
    */
   payment_processor_metadata: Record<string, string>;
   /**
-   * billing_address_fields
+   * Determine which billing address fields should be disabled, optional or required in the checkout form.
    */
   billing_address_fields: CheckoutBillingAddressFields;
   /**
@@ -8561,11 +8577,11 @@ interface CustomerMeter {
    */
   balance: number;
   /**
-   * customer
+   * The customer associated with this meter.
    */
   customer: Customer;
   /**
-   * meter
+   * The meter associated with this customer.
    */
   meter: Meter;
 }
@@ -8740,7 +8756,7 @@ interface CustomerOrderConfirmPayment {
    */
   payment_method_id?: string | null;
   /**
-   * payment_processor
+   * Payment processor used.
    */
   payment_processor?: PaymentProcessor;
 }
@@ -8816,7 +8832,7 @@ interface CustomerOrderProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -8898,7 +8914,7 @@ interface CustomerOrderSubscription {
    */
   currency: string;
   /**
-   * recurring_interval
+   * The interval at which the subscription recurs.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -8906,7 +8922,7 @@ interface CustomerOrderSubscription {
    */
   recurring_interval_count: number;
   /**
-   * status
+   * The status of the subscription.
    */
   status: SubscriptionStatus;
   /**
@@ -9044,7 +9060,7 @@ interface CustomerOrganization {
    */
   avatar_url: string | null;
   /**
-   * proration_behavior
+   * Proration behavior applied when customer updates their subscription from the portal.
    */
   proration_behavior: SubscriptionProrationBehavior;
   /**
@@ -9052,11 +9068,11 @@ interface CustomerOrganization {
    */
   allow_customer_updates: boolean;
   /**
-   * customer_portal_settings
+   * Settings related to the customer portal
    */
   customer_portal_settings: OrganizationCustomerPortalSettings;
   /**
-   * organization_features
+   * Feature flags for the customer portal.
    */
   organization_features?: CustomerOrganizationFeatureSettings;
 }
@@ -9361,7 +9377,7 @@ interface CustomerPortalMember {
    */
   name: string | null;
   /**
-   * role
+   * The role of the member within the team.
    */
   role: MemberRole;
 }
@@ -9378,7 +9394,7 @@ interface CustomerPortalMemberCreate {
    */
   name?: string | null;
   /**
-   * role
+   * The role for the new member. Defaults to 'member'.
    */
   role?: MemberRole;
 }
@@ -9471,7 +9487,7 @@ interface CustomerProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -9540,7 +9556,7 @@ interface CustomerSeat {
    */
   order_id: string | null;
   /**
-   * status
+   * Status of the seat
    */
   status: SeatStatus;
   /**
@@ -9630,7 +9646,7 @@ interface CustomerSeatAssign {
  */
 interface CustomerSeatClaimResponse {
   /**
-   * seat
+   * The claimed seat
    */
   seat: CustomerSeat;
   /**
@@ -9746,11 +9762,11 @@ interface CustomerStateBenefitGrant {
    */
   benefit_id: string;
   /**
-   * benefit_type
+   * The type of the benefit concerned by this grant.
    */
   benefit_type: BenefitType;
   /**
-   * benefit_metadata
+   * The metadata of the benefit concerned by this grant.
    */
   benefit_metadata: MetadataOutputType;
   /**
@@ -9920,7 +9936,7 @@ interface CustomerStateSubscription {
    */
   currency: string;
   /**
-   * recurring_interval
+   * The interval at which the subscription recurs.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -10126,7 +10142,7 @@ interface CustomerSubscription {
    */
   currency: string;
   /**
-   * recurring_interval
+   * The interval at which the subscription recurs.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -10134,7 +10150,7 @@ interface CustomerSubscription {
    */
   recurring_interval_count: number;
   /**
-   * status
+   * The status of the subscription.
    */
   status: SubscriptionStatus;
   /**
@@ -10380,7 +10396,7 @@ interface CustomerSubscriptionProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -10892,7 +10908,7 @@ interface DiscountFixedCreate {
    */
   type?: "fixed";
   /**
-   * duration
+   * For subscriptions, determines if the discount should be applied once on the first invoice, forever, or for a certain number of months determined by `duration_in_months`.
    */
   duration: DiscountDuration;
   /**
@@ -11281,7 +11297,7 @@ interface DiscountPercentageCreate {
    */
   type?: "percentage";
   /**
-   * duration
+   * For subscriptions, determines if the discount should be applied once on the first invoice, forever, or for a certain number of months determined by `duration_in_months`.
    */
   duration: DiscountDuration;
   /**
@@ -11615,7 +11631,7 @@ interface DiscountProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -11754,7 +11770,7 @@ interface Dispute {
    */
   id: string;
   /**
-   * status
+   * Status of the dispute. `prevented` means we issued a refund before the dispute was escalated, avoiding any fees.
    */
   status: DisputeStatus;
   /**
@@ -11798,7 +11814,7 @@ interface Dispute {
    */
   payment_id: string;
   /**
-   * customer
+   * The customer who was charged for the disputed payment.
    */
   customer: DisputeCustomer;
   /**
@@ -11852,7 +11868,7 @@ interface DisputeCustomer {
    */
   email_verified: boolean;
   /**
-   * type
+   * The type of customer: 'individual' for single users, 'team' for customers with multiple members.
    */
   type: CustomerType;
   /**
@@ -12061,8 +12077,18 @@ interface EventCreateCustomer {
    */
   parent_id?: string | null;
   /**
-   * metadata
-   */
+     * Key-value object allowing you to store additional information about the event. Some keys like `_llm` are structured data that are handled specially by Polar.
+  
+  The key must be a string with a maximum length of **40 characters**.
+  The value must be either:
+  
+  * A string with a maximum length of **500 characters**
+  * An integer
+  * A floating-point number
+  * A boolean
+  
+  You can store up to **50 key-value pairs**.
+     */
   metadata?: EventMetadataInput;
   /**
    * ID of the customer in your Polar organization associated with the event.
@@ -12098,8 +12124,18 @@ interface EventCreateExternalCustomer {
    */
   parent_id?: string | null;
   /**
-   * metadata
-   */
+     * Key-value object allowing you to store additional information about the event. Some keys like `_llm` are structured data that are handled specially by Polar.
+  
+  The key must be a string with a maximum length of **40 characters**.
+  The value must be either:
+  
+  * A string with a maximum length of **500 characters**
+  * An integer
+  * A floating-point number
+  * A boolean
+  
+  You can store up to **50 key-value pairs**.
+     */
   metadata?: EventMetadataInput;
   /**
    * ID of the customer in your system associated with the event.
@@ -12151,7 +12187,7 @@ interface EventName {
    */
   label: string;
   /**
-   * source
+   * The source of the event. `system` events are created by Polar. `user` events are the one you create through our ingestion API.
    */
   source: EventSource;
   /**
@@ -12246,7 +12282,7 @@ interface EventTypeWithStats {
    */
   organization_id: string;
   /**
-   * source
+   * The source of the events (system or user).
    */
   source: EventSource;
   /**
@@ -12523,11 +12559,11 @@ interface GenericPayment {
    */
   id: string;
   /**
-   * processor
+   * The payment processor.
    */
   processor: PaymentProcessor;
   /**
-   * status
+   * The payment status.
    */
   status: PaymentStatus;
   /**
@@ -12602,11 +12638,11 @@ interface GrantedLicenseKey {
   /**
    * The ID of the seat member holding this key, if any.
    */
-  member_id?: string | null;
+  member_id: string | null;
   /**
    * The seat member holding this key. Set for keys granted through a seat-based product; `null` for keys granted to the customer directly.
    */
-  member?: LicenseKeyMember | null;
+  member: LicenseKeyMember | null;
   /**
    * The benefit ID.
    */
@@ -12736,11 +12772,11 @@ interface KrCardPayment {
    */
   id: string;
   /**
-   * processor
+   * The payment processor.
    */
   processor: PaymentProcessor;
   /**
-   * status
+   * The payment status.
    */
   status: PaymentStatus;
   /**
@@ -12784,7 +12820,7 @@ interface KrCardPayment {
    */
   processor_metadata?: Record<string, unknown>;
   /**
-   * method_metadata
+   * Additional metadata for the South Korean card payment method.
    */
   method_metadata: KrCardPaymentMetadata;
 }
@@ -12856,7 +12892,7 @@ interface LegacyRecurringProductPriceCustom {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -12884,7 +12920,7 @@ interface LegacyRecurringProductPriceCustom {
    */
   type: "recurring";
   /**
-   * recurring_interval
+   * The recurring interval of the price.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -12922,7 +12958,7 @@ interface LegacyRecurringProductPriceFixed {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -12950,7 +12986,7 @@ interface LegacyRecurringProductPriceFixed {
    */
   type: "recurring";
   /**
-   * recurring_interval
+   * The recurring interval of the price.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -13135,7 +13171,7 @@ interface LicenseKeyCustomer {
    */
   email_verified: boolean;
   /**
-   * type
+   * The type of customer: 'individual' for single users, 'team' for customers with multiple members.
    */
   type: CustomerType;
   /**
@@ -13244,11 +13280,11 @@ interface LicenseKeyRead {
   /**
    * The ID of the seat member holding this key, if any.
    */
-  member_id?: string | null;
+  member_id: string | null;
   /**
    * The seat member holding this key. Set for keys granted through a seat-based product; `null` for keys granted to the customer directly.
    */
-  member?: LicenseKeyMember | null;
+  member: LicenseKeyMember | null;
   /**
    * The benefit ID.
    */
@@ -13389,11 +13425,11 @@ interface LicenseKeyWithActivations {
   /**
    * The ID of the seat member holding this key, if any.
    */
-  member_id?: string | null;
+  member_id: string | null;
   /**
    * The seat member holding this key. Set for keys granted through a seat-based product; `null` for keys granted to the customer directly.
    */
-  member?: LicenseKeyMember | null;
+  member: LicenseKeyMember | null;
   /**
    * The benefit ID.
    */
@@ -13940,7 +13976,7 @@ interface Member {
    */
   external_id: string | null;
   /**
-   * role
+   * The role of the member within the customer.
    */
   role: MemberRole;
 }
@@ -14030,7 +14066,7 @@ interface Meter {
    */
   name: string;
   /**
-   * unit
+   * The unit of the meter.
    */
   unit: MeterUnit;
   /**
@@ -14042,7 +14078,7 @@ interface Meter {
    */
   custom_multiplier?: number | null;
   /**
-   * filter
+   * The filter to apply on events that'll be used to calculate the meter.
    */
   filter: Filter;
   /**
@@ -14081,7 +14117,7 @@ interface MeterCreate {
    */
   name: string;
   /**
-   * unit
+   * The unit of the meter.
    */
   unit?: MeterUnit;
   /**
@@ -14093,7 +14129,7 @@ interface MeterCreate {
    */
   custom_multiplier?: number | null;
   /**
-   * filter
+   * The filter to apply on events that'll be used to calculate the meter.
    */
   filter: Filter;
   /**
@@ -14339,7 +14375,7 @@ interface Metric {
    */
   display_name: string;
   /**
-   * type
+   * Type of the metric, useful to know the unit or format of the value.
    */
   type: MetricType;
 }
@@ -14874,23 +14910,23 @@ interface MetricsIntervalLimit {
  */
 interface MetricsIntervalsLimits {
   /**
-   * hour
+   * Limits for the hour interval.
    */
   hour: MetricsIntervalLimit;
   /**
-   * day
+   * Limits for the day interval.
    */
   day: MetricsIntervalLimit;
   /**
-   * week
+   * Limits for the week interval.
    */
   week: MetricsIntervalLimit;
   /**
-   * month
+   * Limits for the month interval.
    */
   month: MetricsIntervalLimit;
   /**
-   * year
+   * Limits for the year interval.
    */
   year: MetricsIntervalLimit;
 }
@@ -14903,7 +14939,7 @@ interface MetricsLimits {
    */
   min_date: string;
   /**
-   * intervals
+   * Limits for each interval.
    */
   intervals: MetricsIntervalsLimits;
 }
@@ -14916,11 +14952,11 @@ interface MetricsResponse {
    */
   periods: MetricPeriod[];
   /**
-   * totals
+   * Totals for the whole selected period.
    */
   totals: MetricsTotals;
   /**
-   * metrics
+   * Information about the returned metrics.
    */
   metrics: Metrics;
 }
@@ -15593,7 +15629,7 @@ interface OrderCustomer {
    */
   email_verified: boolean;
   /**
-   * type
+   * The type of customer: 'individual' for single users, 'team' for customers with multiple members.
    */
   type: CustomerType;
   /**
@@ -15898,7 +15934,7 @@ interface OrderProduct {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -16046,7 +16082,7 @@ interface OrderSubscription {
    */
   currency: string;
   /**
-   * recurring_interval
+   * The interval at which the subscription recurs.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -16054,7 +16090,7 @@ interface OrderSubscription {
    */
   recurring_interval_count: number;
   /**
-   * status
+   * The status of the subscription.
    */
   status: SubscriptionStatus;
   /**
@@ -16348,7 +16384,7 @@ interface Organization {
    */
   avatar_url: string | null;
   /**
-   * proration_behavior
+   * Proration behavior applied when customer updates their subscription from the portal.
    */
   proration_behavior: SubscriptionProrationBehavior;
   /**
@@ -16368,7 +16404,7 @@ interface Organization {
    */
   socials: OrganizationSocialLink[];
   /**
-   * status
+   * Current organization status
    */
   status: OrganizationStatus;
   /**
@@ -16388,7 +16424,7 @@ interface Organization {
    */
   default_presentment_currency: string;
   /**
-   * default_tax_behavior
+   * Default tax behavior applied on products.
    */
   default_tax_behavior: TaxBehaviorOption;
   /**
@@ -16396,19 +16432,19 @@ interface Organization {
    */
   feature_settings: OrganizationFeatureSettings | null;
   /**
-   * subscription_settings
+   * Settings related to subscriptions management
    */
   subscription_settings: OrganizationSubscriptionSettings;
   /**
-   * customer_email_settings
+   * Settings related to customer emails
    */
   customer_email_settings: OrganizationCustomerEmailSettings;
   /**
-   * customer_portal_settings
+   * Settings related to the customer portal
    */
   customer_portal_settings: OrganizationCustomerPortalSettings;
   /**
-   * dispute_settings
+   * Settings related to disputes
    */
   dispute_settings: OrganizationDisputeSettings;
   /**
@@ -16428,7 +16464,7 @@ interface Organization {
    */
   payout_account_id: string | null;
   /**
-   * capabilities
+   * Capabilities currently granted to the organization.
    */
   capabilities: OrganizationCapabilities;
 }
@@ -16641,11 +16677,11 @@ interface OrganizationCreate {
    */
   customer_portal_settings?: OrganizationCustomerPortalSettings | null;
   /**
-   * default_presentment_currency
+   * Default presentment currency for the organization
    */
   default_presentment_currency?: PresentmentCurrency;
   /**
-   * default_tax_behavior
+   * Default tax behavior applied on products.
    */
   default_tax_behavior?: TaxBehaviorOption;
 }
@@ -16906,7 +16942,7 @@ interface OrganizationNotReadyForPayments {
  */
 interface OrganizationSocialLink {
   /**
-   * platform
+   * The social platform of the URL
    */
   platform: OrganizationSocialPlatforms;
   /**
@@ -17366,7 +17402,7 @@ interface Product {
    */
   description: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility: ProductVisibility;
   /**
@@ -17458,7 +17494,7 @@ interface ProductCreateOneTime {
    */
   description?: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility?: ProductVisibility;
   /**
@@ -17513,7 +17549,7 @@ interface ProductCreateRecurring {
    */
   description?: string | null;
   /**
-   * visibility
+   * The visibility of the product.
    */
   visibility?: ProductVisibility;
   /**
@@ -17541,7 +17577,7 @@ interface ProductCreateRecurring {
    */
   trial_interval_count?: number | null;
   /**
-   * recurring_interval
+   * The recurring interval of the product.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -17697,7 +17733,7 @@ interface ProductPriceCustom {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -17742,7 +17778,7 @@ interface ProductPriceCustomCreate {
    */
   amount_type: "custom";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18049,7 +18085,7 @@ interface ProductPriceFixed {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -18086,7 +18122,7 @@ interface ProductPriceFixedCreate {
    */
   amount_type: "fixed";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18239,7 +18275,7 @@ interface ProductPriceMeter {
    */
   name: string;
   /**
-   * unit
+   * The unit of the meter.
    */
   unit: MeterUnit;
   /**
@@ -18268,7 +18304,7 @@ interface ProductPriceMeteredTiers {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -18300,11 +18336,11 @@ interface ProductPriceMeteredTiers {
    */
   meter_id: string;
   /**
-   * meter
+   * The meter associated to the price.
    */
   meter: ProductPriceMeter;
   /**
-   * tiers
+   * The pricing tiers based on consumed units.
    */
   tiers: Tiers;
 }
@@ -18317,7 +18353,7 @@ interface ProductPriceMeteredTiersCreate {
    */
   amount_type: "metered_tiers";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18329,7 +18365,7 @@ interface ProductPriceMeteredTiersCreate {
    */
   meter_id: string;
   /**
-   * tiers
+   * Tiered pricing based on consumed units.
    */
   tiers: TiersInput;
   /**
@@ -18354,7 +18390,7 @@ interface ProductPriceMeteredUnit {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -18386,7 +18422,7 @@ interface ProductPriceMeteredUnit {
    */
   meter_id: string;
   /**
-   * meter
+   * The meter associated to the price.
    */
   meter: ProductPriceMeter;
   /**
@@ -18403,7 +18439,7 @@ interface ProductPriceMeteredUnitCreate {
    */
   amount_type: "metered_unit";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18440,7 +18476,7 @@ interface ProductPriceSeatBased {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -18464,7 +18500,7 @@ interface ProductPriceSeatBased {
    */
   product_id: string;
   /**
-   * seat_tiers
+   * Tiered pricing based on seat quantity
    */
   seat_tiers: ProductPriceSeatTiersOutput;
 }
@@ -18477,7 +18513,7 @@ interface ProductPriceSeatBasedCreate {
    */
   amount_type: "seat_based";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18485,7 +18521,7 @@ interface ProductPriceSeatBasedCreate {
    */
   tax_behavior?: TaxBehaviorOption | null;
   /**
-   * seat_tiers
+   * Tiered pricing based on seat quantity
    */
   seat_tiers: ProductPriceSeatTiersInput;
 }
@@ -18515,7 +18551,7 @@ The minimum and maximum seat limits are derived from the tiers:
  */
 interface ProductPriceSeatTiersInput {
   /**
-   * seat_tier_type
+   * How tiers are applied. 'volume' prices all seats at the matching tier's rate. 'graduated' prices each tier's range independently.
    */
   seat_tier_type?: SeatTierType;
   /**
@@ -18532,7 +18568,7 @@ The minimum and maximum seat limits are derived from the tiers:
  */
 interface ProductPriceSeatTiersOutput {
   /**
-   * seat_tier_type
+   * How tiers are applied. 'volume' prices all seats at the matching tier's rate. 'graduated' prices each tier's range independently.
    */
   seat_tier_type?: SeatTierType;
   /**
@@ -18566,7 +18602,7 @@ interface ProductPriceUnitBased {
    */
   id: string;
   /**
-   * source
+   * The source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session.
    */
   source: ProductPriceSource;
   /**
@@ -18590,7 +18626,7 @@ interface ProductPriceUnitBased {
    */
   product_id: string;
   /**
-   * tiers
+   * Tiered pricing based on the purchased unit quantity.
    */
   tiers: Tiers;
   /**
@@ -18616,7 +18652,7 @@ interface ProductPriceUnitBasedCreate {
    */
   amount_type: "unit_based";
   /**
-   * price_currency
+   * The currency in which the customer will be charged.
    */
   price_currency?: PresentmentCurrency;
   /**
@@ -18624,7 +18660,7 @@ interface ProductPriceUnitBasedCreate {
    */
   tax_behavior?: TaxBehaviorOption | null;
   /**
-   * tiers
+   * Tiered pricing based on the purchased unit quantity.
    */
   tiers: TiersInput;
   /**
@@ -18839,7 +18875,7 @@ interface RefundDispute {
    */
   id: string;
   /**
-   * status
+   * Status of the dispute. `prevented` means we issued a refund before the dispute was escalated, avoiding any fees.
    */
   status: DisputeStatus;
   /**
@@ -18957,11 +18993,11 @@ interface RotatedLicenseKey {
   /**
    * The ID of the seat member holding this key, if any.
    */
-  member_id?: string | null;
+  member_id: string | null;
   /**
    * The seat member holding this key. Set for keys granted through a seat-based product; `null` for keys granted to the customer directly.
    */
-  member?: LicenseKeyMember | null;
+  member: LicenseKeyMember | null;
   /**
    * The benefit ID.
    */
@@ -19252,7 +19288,7 @@ interface Subscription {
    */
   currency: string;
   /**
-   * recurring_interval
+   * The interval at which the subscription recurs.
    */
   recurring_interval: RecurringInterval;
   /**
@@ -19260,7 +19296,7 @@ interface Subscription {
    */
   recurring_interval_count: number;
   /**
-   * status
+   * The status of the subscription.
    */
   status: SubscriptionStatus;
   /**
@@ -19800,7 +19836,7 @@ interface SubscriptionCustomer {
    */
   email_verified: boolean;
   /**
-   * type
+   * The type of customer: 'individual' for single users, 'team' for customers with multiple members.
    */
   type: CustomerType;
   /**
@@ -19980,7 +20016,7 @@ interface SubscriptionMeter {
    */
   meter_id: string;
   /**
-   * meter
+   * The meter associated with this subscription.
    */
   meter: Meter;
 }
@@ -21686,11 +21722,11 @@ interface ValidatedLicenseKey {
   /**
    * The ID of the seat member holding this key, if any.
    */
-  member_id?: string | null;
+  member_id: string | null;
   /**
    * The seat member holding this key. Set for keys granted through a seat-based product; `null` for keys granted to the customer directly.
    */
-  member?: LicenseKeyMember | null;
+  member: LicenseKeyMember | null;
   /**
    * The benefit ID.
    */
@@ -21790,7 +21826,7 @@ interface WebhookDelivery {
    */
   response: string | null;
   /**
-   * webhook_event
+   * The webhook event sent by this delivery.
    */
   webhook_event: WebhookEvent;
 }
@@ -21823,7 +21859,7 @@ interface WebhookEndpoint {
    */
   api_version: string;
   /**
-   * format
+   * The format of the webhook payload.
    */
   format: WebhookFormat;
   /**
@@ -21864,7 +21900,7 @@ interface WebhookEndpointCreate {
    */
   api_version?: ApiVersion;
   /**
-   * format
+   * The format of the webhook payload.
    */
   format: WebhookFormat;
   /**
@@ -21948,7 +21984,7 @@ interface WebhookEvent {
    */
   payload: string | null;
   /**
-   * type
+   * The type of the webhook event.
    */
   type: WebhookEventType;
   /**
@@ -22078,4 +22114,4 @@ type SubscriptionUpdate = SubscriptionUpdateBase | SubscriptionUpdateSeats | Sub
 type SystemEvent = MeterCreditEvent | MeterResetEvent | BenefitGrantedEvent | BenefitCycledEvent | BenefitUpdatedEvent | BenefitRevokedEvent | SubscriptionCreatedEvent | SubscriptionUpdatedEvent | SubscriptionCycledEvent | SubscriptionCanceledEvent | SubscriptionRevokedEvent | SubscriptionPastDueEvent | SubscriptionReactivatedEvent | SubscriptionReinstatedEvent | SubscriptionPausedEvent | SubscriptionResumedEvent | SubscriptionMigratedEvent | SubscriptionUncanceledEvent | SubscriptionProductUpdatedEvent | SubscriptionSeatsUpdatedEvent | SubscriptionUnitsUpdatedEvent | SubscriptionBillingPeriodUpdatedEvent | SubscriptionUpdateClearedEvent | OrderPaidEvent | OrderRefundedEvent | OrderVoidedEvent | OrderUnvoidedEvent | CheckoutCreatedEvent | CustomerCreatedEvent | CustomerUpdatedEvent | CustomerDeletedEvent | BalanceOrderEvent | BalanceCreditOrderEvent | BalanceRefundEvent | BalanceRefundReversalEvent | BalanceDisputeEvent | BalanceDisputeReversalEvent;
 //#endregion
 export { CustomerEmailUpdateRequest as $, ListResourceRefund as $n, PaymentNotReady as $r, EventType as $t, CheckoutLinkSortProperty as A, SubscriptionSortProperty as Ai, ListResourceCustomerBenefitGrant as An, OrderInvoice as Ar, CustomerState as At, CustomFieldCreate as B, UserInfoOrganization as Bi, ListResourceDownloadableRead as Bn, OrganizationNotReadyForPayments as Br, DiscountSortProperty as Bt, CannotCreateOrganizationError as C, SeatsList as Ci, ListResourceBenefit as Cn, OAuth2ClientConfiguration as Cr, CustomerSeat as Ct, CheckoutForbiddenError as D, SubscriptionExportColumn as Di, ListResourceCheckoutLink as Dn, OrderCreate as Dr, CustomerSessionCustomerExternalIDCreate as Dt, CheckoutCreate as E, SubscriptionCreateExternalCustomer as Ei, ListResourceCheckout as En, Order as Er, CustomerSession as Et, CheckoutSortProperty as F, TokenResponse as Fi, ListResourceCustomerPortalMember as Fn, OrderSortProperty as Fr, CustomerUpdateExternalID as Ft, CustomerBenefitGrant as G, WebhookEndpointCreate as Gi, ListResourceLicenseKeyRead as Gn, PaymentActionRequired as Gr, DisputeSortProperty as Gt, CustomFieldType as H, ValidatedLicenseKey as Hi, ListResourceEventName as Hn, OrganizationUpdate as Hr, Dispute as Ht, CheckoutStatus as I, Unauthorized as Ii, ListResourceCustomerSubscription as In, OrderStatus as Ir, CustomerWallet as It, CustomerCancellationReason as J, models_d_exports as Ji, ListResourceOrder as Jn, PaymentFailed as Jr, Event as Jt, CustomerBenefitGrantSortProperty as K, WebhookEndpointUpdate as Ki, ListResourceMember as Kn, PaymentAlreadyInProgress as Kr, DisputeStatus as Kt, CheckoutUpdate as L, UpdateSubscriptionPlanNotAllowed as Li, ListResourceCustomerWallet as Ln, OrderUpdate as Lr, CustomerWalletSortProperty as Lt, CheckoutLocked as M, SubscriptionUpdate as Mi, ListResourceCustomerMeter as Mn, OrderNotEligibleForInvoice as Mr, CustomerSubscriptionSortProperty as Mt, CheckoutPublic as N, TimeInterval as Ni, ListResourceCustomerOrder as Nn, OrderNotEligibleForRetry as Nr, CustomerSubscriptionUpdate as Nt, CheckoutLink as O, SubscriptionLocked as Oi, ListResourceCustomField as On, OrderExportColumn as Or, CustomerSessionCustomerIDCreate as Ot, CheckoutPublicConfirmed as P, Timezone as Pi, ListResourceCustomerPaymentMethod as Pn, OrderReceipt as Pr, CustomerUpdate as Pt, CustomerCustomerSession as Q, ListResourceProduct as Qn, PaymentMethodSetupFailed as Qr, EventSource as Qt, CheckoutUpdatePublic as R, UpdateSubscriptionSeatsNotAllowed as Ri, ListResourceDiscount as Rn, Organization as Rr, Discount as Rt, BenefitType as S, SeatClaimInfo as Si, LicenseKeyWithActivations as Sn, NotPermitted as Sr, CustomerPortalMemberUpdate as St, CheckoutConfirmStripe as T, SubscriptionCreateCustomer as Ti, ListResourceBenefitGrant as Tn, OffSessionChargesNotEnabled as Tr, CustomerSeatClaimResponse as Tt, CustomFieldUpdate as U, WebhookDelivery as Ui, ListResourceEventTypeWithStats as Un, PauseResumeNotAllowed as Ur, DisputeAutoAcceptNotEnabled as Ut, CustomFieldSortProperty as V, UserInfoUser as Vi, ListResourceEvent as Vn, OrganizationSortProperty as Vr, DiscountUpdate as Vt, Customer as W, WebhookEndpoint as Wi, ListResourceFileRead as Wn, Payment as Wr, DisputeNotOpenError as Wt, CustomerCustomerMeter as X, ListResourcePayment as Xn, PaymentMethodInUseByActiveSubscription as Xr, EventNamesSortProperty as Xt, CustomerCreate as Y, ListResourceOrganization as Yn, PaymentMethod as Yr, EventName as Yt, CustomerCustomerMeterSortProperty as Z, ListResourcePaymentMethod as Zn, PaymentMethodRequired as Zr, EventSortProperty as Zt, BenefitGrantWebhook as _, RotateNotPermitted as _i, LicenseKeyDeactivate as _n, MetricDashboardSchema as _r, CustomerPaymentMethodCreateResponse as _t, AuthorizeResponseUser as a, ProductBillingType as ai, ExpiredCheckoutError as an, Member as ar, CustomerOrder as at, BenefitSlackSharedChannelUpdate as b, SeatAssign as bi, LicenseKeyUpdate as bn, MetricsResponse as br, CustomerPortalMember as bt, BenefitCreate as c, ProductSortProperty as ci, FileRead as cn, MemberSortProperty as cr, CustomerOrderPaymentConfirmation as ct, BenefitDownloadableFile as d, Refund as di, HTTPValidationError as dn, Meter as dr, CustomerOrderSortProperty as dt, PaymentSortProperty as ei, EventTypeUpdate as en, ListResourceSubscription as er, CustomerEmailUpdateVerifyRequest as et, BenefitDownloadablesUpdate as f, RefundCreate as fi, InactiveSubscription as fn, MeterCreate as fr, CustomerOrderUpdate as ft, BenefitGrantSortProperty as g, RevokeTokenResponse as gi, LicenseKeyActivationRead as gn, MetricDashboardCreate as gr, CustomerPaymentMethodCreate as gt, BenefitGrant as h, ResourceNotFound as hi, LicenseKeyActivationCreated as hn, MeterUpdate as hr, CustomerPaymentMethodConfirm as ht, AuthorizeResponseOrganization as i, ProductBenefitsUpdate as ii, EventsIngestResponse as in, ManualRetryLimitExceeded as ir, CustomerNotReady as it, CheckoutLinkUpdate as j, SubscriptionStatus as ji, ListResourceCustomerCustomerMeter as jn, OrderNotDraft as jr, CustomerSubscription as jt, CheckoutLinkCreate as k, SubscriptionNotScheduledToCancel as ki, ListResourceCustomer as kn, OrderFinalize as kr, CustomerSortProperty as kt, BenefitCustomUpdate as l, ProductUpdate as li, FileUpload as ln, MemberUpdate as lr, CustomerOrderPaymentStatus as lt, BenefitGitHubRepositoryUpdate as m, RefundedAlready as mi, LicenseKeyActivate as mn, MeterSortProperty as mr, CustomerPaymentMethod as mt, AlreadyCanceledSubscription as n, PortalAuthenticatedUser as ni, EventTypesSortProperty as nn, ListResourceWebhookEndpoint as nr, CustomerMeter as nt, BadRequest as o, ProductCreate as oi, FileCreate as on, MemberCreateFromCustomer as or, CustomerOrderConfirmPayment as ot, BenefitFeatureFlagUpdate as p, RefundSortProperty as pi, IntrospectTokenResponse as pn, MeterQuantities as pr, CustomerOrganizationData as pt, CustomerBenefitGrantUpdate as q, WebhookEventType as qi, ListResourceMeter as qn, PaymentError as qr, DownloadableRead as qt, AmbiguousExternalCustomerID as r, Product as ri, EventsIngest as rn, ListResourceWithCursorPaginationEvent as rr, CustomerMeterSortProperty as rt, Benefit as s, ProductNotDeletable as si, FilePatch as sn, MemberRole as sr, CustomerOrderInvoice as st, AggregationFunction as t, PaymentStatus as ti, EventTypeWithStats as tn, ListResourceWebhookDelivery as tr, CustomerEmailUpdateVerifyResponse as tt, BenefitDiscordUpdate as u, ProductVisibility as ui, FileUploadCompleted as un, MetadataQuery as ur, CustomerOrderReceipt as ut, BenefitLicenseKeysUpdate as v, RotatedLicenseKey as vi, LicenseKeyRead as vn, MetricDashboardUpdate as vr, CustomerPortalCustomer as vt, Checkout as w, Subscription as wi, ListResourceBenefitDownloadableFile as wn, OAuth2ClientConfigurationUpdate as wr, CustomerSeatAssign as wt, BenefitSortProperty as x, SeatClaim as xi, LicenseKeyValidate as xn, MissingInvoiceBillingDetails as xr, CustomerPortalMemberCreate as xt, BenefitMeterCreditUpdate as y, SSOEnforcementRequiresConnection as yi, LicenseKeyStatus as yn, MetricsLimits as yr, CustomerPortalCustomerUpdate as yt, CustomField as z, UpdateSubscriptionUnitsNotAllowed as zi, ListResourceDispute as zn, OrganizationCreate as zr, DiscountCreate as zt };
-//# sourceMappingURL=models-DjSYF7EH.d.cts.map
+//# sourceMappingURL=models-P8aaHkKR.d.cts.map