@polar-sh/sdk 0.48.1 → 0.49.0

package/src/models/components/organizationfeaturesettings.ts

@@ -29,10 +29,6 @@ export type OrganizationFeatureSettings = {
    * If this organization has checkout localization enabled
    */
   checkoutLocalizationEnabled?: boolean | undefined;
-  /**
-   * If this organization sees the new account review checklist UI.
-   */
-  accountReviewV2Enabled?: boolean | undefined;
   /**
    * Ordered list of metric slugs shown on the dashboard overview.
    */
@@ -45,14 +41,30 @@ export type OrganizationFeatureSettings = {
    * If this organization can create and finalize draft orders via the API (off-session charges against a saved payment method).
    */
   offSessionChargesEnabled?: boolean | undefined;
-  /**
-   * If this organization has billing enabled
-   */
-  billingEnabled?: boolean | undefined;
   /**
    * Enables the slack shared channel benefit
    */
   slackBenefitEnabled?: boolean | undefined;
+  /**
+   * If this organization has preview access to new features enabled
+   */
+  previewAccessEnabled?: boolean | undefined;
+  /**
+   * If this organization has the disputes dashboard enabled
+   */
+  disputesEnabled?: boolean | undefined;
+  /**
+   * If this organization has single sign-on configuration enabled
+   */
+  ssoEnabled?: boolean | undefined;
+  /**
+   * If this organization has the split product navigation (Billing / Compass / Customers) enabled in the dashboard
+   */
+  compassEnabled?: boolean | undefined;
+  /**
+   * If this organization can migrate its billing from another provider (e.g. Stripe) to Polar.
+   */
+  merchantMigrationEnabled?: boolean | undefined;
 };
 
 /** @internal */
@@ -66,12 +78,15 @@ export const OrganizationFeatureSettings$inboundSchema: z.ZodMiniType<
     wallets_enabled: z._default(z.boolean(), false),
     member_model_enabled: z._default(z.boolean(), false),
     checkout_localization_enabled: z._default(z.boolean(), false),
-    account_review_v2_enabled: z._default(z.boolean(), false),
     overview_metrics: z.optional(z.nullable(z.array(z.string()))),
     reset_proration_behavior_enabled: z._default(z.boolean(), false),
     off_session_charges_enabled: z._default(z.boolean(), false),
-    billing_enabled: z._default(z.boolean(), false),
     slack_benefit_enabled: z._default(z.boolean(), false),
+    preview_access_enabled: z._default(z.boolean(), false),
+    disputes_enabled: z._default(z.boolean(), false),
+    sso_enabled: z._default(z.boolean(), false),
+    compass_enabled: z._default(z.boolean(), false),
+    merchant_migration_enabled: z._default(z.boolean(), false),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -80,12 +95,15 @@ export const OrganizationFeatureSettings$inboundSchema: z.ZodMiniType<
       "wallets_enabled": "walletsEnabled",
       "member_model_enabled": "memberModelEnabled",
       "checkout_localization_enabled": "checkoutLocalizationEnabled",
-      "account_review_v2_enabled": "accountReviewV2Enabled",
       "overview_metrics": "overviewMetrics",
       "reset_proration_behavior_enabled": "resetProrationBehaviorEnabled",
       "off_session_charges_enabled": "offSessionChargesEnabled",
-      "billing_enabled": "billingEnabled",
       "slack_benefit_enabled": "slackBenefitEnabled",
+      "preview_access_enabled": "previewAccessEnabled",
+      "disputes_enabled": "disputesEnabled",
+      "sso_enabled": "ssoEnabled",
+      "compass_enabled": "compassEnabled",
+      "merchant_migration_enabled": "merchantMigrationEnabled",
     });
   }),
 );
@@ -96,12 +114,15 @@ export type OrganizationFeatureSettings$Outbound = {
   wallets_enabled: boolean;
   member_model_enabled: boolean;
   checkout_localization_enabled: boolean;
-  account_review_v2_enabled: boolean;
   overview_metrics?: Array<string> | null | undefined;
   reset_proration_behavior_enabled: boolean;
   off_session_charges_enabled: boolean;
-  billing_enabled: boolean;
   slack_benefit_enabled: boolean;
+  preview_access_enabled: boolean;
+  disputes_enabled: boolean;
+  sso_enabled: boolean;
+  compass_enabled: boolean;
+  merchant_migration_enabled: boolean;
 };
 
 /** @internal */
@@ -115,12 +136,15 @@ export const OrganizationFeatureSettings$outboundSchema: z.ZodMiniType<
     walletsEnabled: z._default(z.boolean(), false),
     memberModelEnabled: z._default(z.boolean(), false),
     checkoutLocalizationEnabled: z._default(z.boolean(), false),
-    accountReviewV2Enabled: z._default(z.boolean(), false),
     overviewMetrics: z.optional(z.nullable(z.array(z.string()))),
     resetProrationBehaviorEnabled: z._default(z.boolean(), false),
     offSessionChargesEnabled: z._default(z.boolean(), false),
-    billingEnabled: z._default(z.boolean(), false),
     slackBenefitEnabled: z._default(z.boolean(), false),
+    previewAccessEnabled: z._default(z.boolean(), false),
+    disputesEnabled: z._default(z.boolean(), false),
+    ssoEnabled: z._default(z.boolean(), false),
+    compassEnabled: z._default(z.boolean(), false),
+    merchantMigrationEnabled: z._default(z.boolean(), false),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -129,12 +153,15 @@ export const OrganizationFeatureSettings$outboundSchema: z.ZodMiniType<
       walletsEnabled: "wallets_enabled",
       memberModelEnabled: "member_model_enabled",
       checkoutLocalizationEnabled: "checkout_localization_enabled",
-      accountReviewV2Enabled: "account_review_v2_enabled",
       overviewMetrics: "overview_metrics",
       resetProrationBehaviorEnabled: "reset_proration_behavior_enabled",
       offSessionChargesEnabled: "off_session_charges_enabled",
-      billingEnabled: "billing_enabled",
       slackBenefitEnabled: "slack_benefit_enabled",
+      previewAccessEnabled: "preview_access_enabled",
+      disputesEnabled: "disputes_enabled",
+      ssoEnabled: "sso_enabled",
+      compassEnabled: "compass_enabled",
+      merchantMigrationEnabled: "merchant_migration_enabled",
     });
   }),
 );

package/src/models/components/organizationfeaturesettingsupdate.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+/**
+ * Feature settings that organizations can update themselves.
+ *
+ * @remarks
+ *
+ * Other feature settings are managed by Polar staff: they're ignored if
+ * provided and keep their current value.
+ */
+export type OrganizationFeatureSettingsUpdate = {
+  /**
+   * If this organization has seat-based pricing enabled
+   */
+  seatBasedPricingEnabled?: boolean | undefined;
+  /**
+   * If this organization has the Member model enabled
+   */
+  memberModelEnabled?: boolean | undefined;
+  /**
+   * If this organization has checkout localization enabled
+   */
+  checkoutLocalizationEnabled?: boolean | undefined;
+  /**
+   * Ordered list of metric slugs shown on the dashboard overview.
+   */
+  overviewMetrics?: Array<string> | null | undefined;
+};
+
+/** @internal */
+export type OrganizationFeatureSettingsUpdate$Outbound = {
+  seat_based_pricing_enabled: boolean;
+  member_model_enabled: boolean;
+  checkout_localization_enabled: boolean;
+  overview_metrics?: Array<string> | null | undefined;
+};
+
+/** @internal */
+export const OrganizationFeatureSettingsUpdate$outboundSchema: z.ZodMiniType<
+  OrganizationFeatureSettingsUpdate$Outbound,
+  OrganizationFeatureSettingsUpdate
+> = z.pipe(
+  z.object({
+    seatBasedPricingEnabled: z._default(z.boolean(), false),
+    memberModelEnabled: z._default(z.boolean(), false),
+    checkoutLocalizationEnabled: z._default(z.boolean(), false),
+    overviewMetrics: z.optional(z.nullable(z.array(z.string()))),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      seatBasedPricingEnabled: "seat_based_pricing_enabled",
+      memberModelEnabled: "member_model_enabled",
+      checkoutLocalizationEnabled: "checkout_localization_enabled",
+      overviewMetrics: "overview_metrics",
+    });
+  }),
+);
+
+export function organizationFeatureSettingsUpdateToJSON(
+  organizationFeatureSettingsUpdate: OrganizationFeatureSettingsUpdate,
+): string {
+  return JSON.stringify(
+    OrganizationFeatureSettingsUpdate$outboundSchema.parse(
+      organizationFeatureSettingsUpdate,
+    ),
+  );
+}

package/src/models/components/organizationstatus.ts

@@ -14,6 +14,7 @@ export const OrganizationStatus = {
   Active: "active",
   Blocked: "blocked",
   Offboarding: "offboarding",
+  Offboarded: "offboarded",
 } as const;
 export type OrganizationStatus = OpenEnum<typeof OrganizationStatus>;
 

package/src/models/components/organizationupdate.ts

@@ -21,15 +21,10 @@ import {
   OrganizationDetails$outboundSchema,
 } from "./organizationdetails.js";
 import {
-  OrganizationFeatureSettings,
-  OrganizationFeatureSettings$Outbound,
-  OrganizationFeatureSettings$outboundSchema,
-} from "./organizationfeaturesettings.js";
-import {
-  OrganizationNotificationSettings,
-  OrganizationNotificationSettings$Outbound,
-  OrganizationNotificationSettings$outboundSchema,
-} from "./organizationnotificationsettings.js";
+  OrganizationFeatureSettingsUpdate,
+  OrganizationFeatureSettingsUpdate$Outbound,
+  OrganizationFeatureSettingsUpdate$outboundSchema,
+} from "./organizationfeaturesettingsupdate.js";
 import {
   OrganizationSocialLink,
   OrganizationSocialLink$Outbound,
@@ -322,9 +317,8 @@ export type OrganizationUpdate = {
    * Two-letter country code (ISO 3166-1 alpha-2).
    */
   country?: CountryCountryAlpha2Input | null | undefined;
-  featureSettings?: OrganizationFeatureSettings | null | undefined;
+  featureSettings?: OrganizationFeatureSettingsUpdate | null | undefined;
   subscriptionSettings?: OrganizationSubscriptionSettings | null | undefined;
-  notificationSettings?: OrganizationNotificationSettings | null | undefined;
   customerEmailSettings?: OrganizationCustomerEmailSettings | null | undefined;
   customerPortalSettings?:
     | OrganizationCustomerPortalSettings
@@ -338,6 +332,10 @@ export type OrganizationUpdate = {
    * Default tax behavior applied on products.
    */
   defaultTaxBehavior?: TaxBehaviorOption | null | undefined;
+  /**
+   * Whether members must access this organization through its SSO connection. Turning this on requires an active SSO session for this organization and at least one enabled SSO connection.
+   */
+  ssoEnforced?: boolean | null | undefined;
 };
 
 /** @internal */
@@ -354,13 +352,12 @@ export type OrganizationUpdate$Outbound = {
   socials?: Array<OrganizationSocialLink$Outbound> | null | undefined;
   details?: OrganizationDetails$Outbound | null | undefined;
   country?: string | null | undefined;
-  feature_settings?: OrganizationFeatureSettings$Outbound | null | undefined;
-  subscription_settings?:
-    | OrganizationSubscriptionSettings$Outbound
+  feature_settings?:
+    | OrganizationFeatureSettingsUpdate$Outbound
     | null
     | undefined;
-  notification_settings?:
-    | OrganizationNotificationSettings$Outbound
+  subscription_settings?:
+    | OrganizationSubscriptionSettings$Outbound
     | null
     | undefined;
   customer_email_settings?:
@@ -373,6 +370,7 @@ export type OrganizationUpdate$Outbound = {
     | undefined;
   default_presentment_currency?: string | null | undefined;
   default_tax_behavior?: string | null | undefined;
+  sso_enforced?: boolean | null | undefined;
 };
 
 /** @internal */
@@ -391,14 +389,11 @@ export const OrganizationUpdate$outboundSchema: z.ZodMiniType<
     details: z.optional(z.nullable(OrganizationDetails$outboundSchema)),
     country: z.optional(z.nullable(CountryCountryAlpha2Input$outboundSchema)),
     featureSettings: z.optional(
-      z.nullable(OrganizationFeatureSettings$outboundSchema),
+      z.nullable(OrganizationFeatureSettingsUpdate$outboundSchema),
     ),
     subscriptionSettings: z.optional(
       z.nullable(OrganizationSubscriptionSettings$outboundSchema),
     ),
-    notificationSettings: z.optional(
-      z.nullable(OrganizationNotificationSettings$outboundSchema),
-    ),
     customerEmailSettings: z.optional(
       z.nullable(OrganizationCustomerEmailSettings$outboundSchema),
     ),
@@ -411,17 +406,18 @@ export const OrganizationUpdate$outboundSchema: z.ZodMiniType<
     defaultTaxBehavior: z.optional(
       z.nullable(TaxBehaviorOption$outboundSchema),
     ),
+    ssoEnforced: z.optional(z.nullable(z.boolean())),
   }),
   z.transform((v) => {
     return remap$(v, {
       avatarUrl: "avatar_url",
       featureSettings: "feature_settings",
       subscriptionSettings: "subscription_settings",
-      notificationSettings: "notification_settings",
       customerEmailSettings: "customer_email_settings",
       customerPortalSettings: "customer_portal_settings",
       defaultPresentmentCurrency: "default_presentment_currency",
       defaultTaxBehavior: "default_tax_behavior",
+      ssoEnforced: "sso_enforced",
     });
   }),
 );

package/src/models/components/paymenttrigger.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+export const PaymentTrigger = {
+  Purchase: "purchase",
+  SubscriptionCycle: "subscription_cycle",
+  RetryDunning: "retry_dunning",
+  RetryCustomer: "retry_customer",
+  RetryPaymentMethodUpdate: "retry_payment_method_update",
+  RetryAdmin: "retry_admin",
+} as const;
+export type PaymentTrigger = OpenEnum<typeof PaymentTrigger>;
+
+/** @internal */
+export const PaymentTrigger$inboundSchema: z.ZodMiniType<
+  PaymentTrigger,
+  unknown
+> = openEnums.inboundSchema(PaymentTrigger);

package/src/models/components/product.ts

@@ -50,10 +50,10 @@ import {
   ProductVisibility$outboundSchema,
 } from "./productvisibility.js";
 import {
-  SubscriptionRecurringInterval,
-  SubscriptionRecurringInterval$inboundSchema,
-  SubscriptionRecurringInterval$outboundSchema,
-} from "./subscriptionrecurringinterval.js";
+  RecurringInterval,
+  RecurringInterval$inboundSchema,
+  RecurringInterval$outboundSchema,
+} from "./recurringinterval.js";
 import {
   TrialInterval,
   TrialInterval$inboundSchema,
@@ -98,11 +98,19 @@ export type Product = {
   /**
    * The recurring interval of the product. If `None`, the product is a one-time purchase.
    */
-  recurringInterval: SubscriptionRecurringInterval | null;
+  recurringInterval: RecurringInterval | null;
   /**
    * Number of interval units of the subscription. If this is set to 1 the charge will happen every interval (e.g. every month), if set to 2 it will be every other month, and so on. None for one-time products.
    */
   recurringIntervalCount: number | null;
+  /**
+   * The meter cycle of the product, independent of the billing interval. If `None`, metered concerns follow the billing interval.
+   */
+  meterInterval: RecurringInterval | null;
+  /**
+   * Number of meter interval units. None when no meter cycle is set.
+   */
+  meterIntervalCount: number | null;
   /**
    * Whether the product is a subscription.
    */
@@ -180,8 +188,10 @@ export const Product$inboundSchema: z.ZodMiniType<Product, unknown> = z.pipe(
     name: z.string(),
     description: z.nullable(z.string()),
     visibility: ProductVisibility$inboundSchema,
-    recurring_interval: z.nullable(SubscriptionRecurringInterval$inboundSchema),
+    recurring_interval: z.nullable(RecurringInterval$inboundSchema),
     recurring_interval_count: z.nullable(z.int()),
+    meter_interval: z.nullable(RecurringInterval$inboundSchema),
+    meter_interval_count: z.nullable(z.int()),
     is_recurring: z.boolean(),
     is_archived: z.boolean(),
     organization_id: z.string(),
@@ -204,6 +214,8 @@ export const Product$inboundSchema: z.ZodMiniType<Product, unknown> = z.pipe(
       "trial_interval_count": "trialIntervalCount",
       "recurring_interval": "recurringInterval",
       "recurring_interval_count": "recurringIntervalCount",
+      "meter_interval": "meterInterval",
+      "meter_interval_count": "meterIntervalCount",
       "is_recurring": "isRecurring",
       "is_archived": "isArchived",
       "organization_id": "organizationId",
@@ -223,6 +235,8 @@ export type Product$Outbound = {
   visibility: string;
   recurring_interval: string | null;
   recurring_interval_count: number | null;
+  meter_interval: string | null;
+  meter_interval_count: number | null;
   is_recurring: boolean;
   is_archived: boolean;
   organization_id: string;
@@ -247,10 +261,10 @@ export const Product$outboundSchema: z.ZodMiniType<Product$Outbound, Product> =
       name: z.string(),
       description: z.nullable(z.string()),
       visibility: ProductVisibility$outboundSchema,
-      recurringInterval: z.nullable(
-        SubscriptionRecurringInterval$outboundSchema,
-      ),
+      recurringInterval: z.nullable(RecurringInterval$outboundSchema),
       recurringIntervalCount: z.nullable(z.int()),
+      meterInterval: z.nullable(RecurringInterval$outboundSchema),
+      meterIntervalCount: z.nullable(z.int()),
       isRecurring: z.boolean(),
       isArchived: z.boolean(),
       organizationId: z.string(),
@@ -273,6 +287,8 @@ export const Product$outboundSchema: z.ZodMiniType<Product$Outbound, Product> =
         trialIntervalCount: "trial_interval_count",
         recurringInterval: "recurring_interval",
         recurringIntervalCount: "recurring_interval_count",
+        meterInterval: "meter_interval",
+        meterIntervalCount: "meter_interval_count",
         isRecurring: "is_recurring",
         isArchived: "is_archived",
         organizationId: "organization_id",

package/src/models/components/productcreateonetime.ts

@@ -20,11 +20,6 @@ import {
   ProductPriceFixedCreate$Outbound,
   ProductPriceFixedCreate$outboundSchema,
 } from "./productpricefixedcreate.js";
-import {
-  ProductPriceFreeCreate,
-  ProductPriceFreeCreate$Outbound,
-  ProductPriceFreeCreate$outboundSchema,
-} from "./productpricefreecreate.js";
 import {
   ProductPriceMeteredUnitCreate,
   ProductPriceMeteredUnitCreate$Outbound,
@@ -45,7 +40,6 @@ export type ProductCreateOneTimeMetadata = string | number | number | boolean;
 export type ProductCreateOneTimePrices =
   | ProductPriceCustomCreate
   | ProductPriceFixedCreate
-  | ProductPriceFreeCreate
   | ProductPriceMeteredUnitCreate
   | ProductPriceSeatBasedCreate;
 
@@ -76,12 +70,11 @@ export type ProductCreateOneTime = {
   description?: string | null | undefined;
   visibility?: ProductVisibility | undefined;
   /**
-   * List of available prices for this product. It should contain at most one static price (fixed, custom or free), and any number of metered prices. Metered prices are not supported on one-time purchase products.
+   * List of available prices for this product. It may combine at most one fixed price with one seat-based price (billed as `fixed + seat_charge`), or contain a single custom or free price, plus any number of metered prices. A free price cannot be combined with other prices, and a custom price cannot be combined with a fixed or seat-based price. Metered prices are not supported on one-time purchase products.
    */
   prices: Array<
     | ProductPriceCustomCreate
     | ProductPriceFixedCreate
-    | ProductPriceFreeCreate
     | ProductPriceMeteredUnitCreate
     | ProductPriceSeatBasedCreate
   >;
@@ -134,7 +127,6 @@ export function productCreateOneTimeMetadataToJSON(
 export type ProductCreateOneTimePrices$Outbound =
   | ProductPriceCustomCreate$Outbound
   | ProductPriceFixedCreate$Outbound
-  | ProductPriceFreeCreate$Outbound
   | ProductPriceMeteredUnitCreate$Outbound
   | ProductPriceSeatBasedCreate$Outbound;
 
@@ -145,7 +137,6 @@ export const ProductCreateOneTimePrices$outboundSchema: z.ZodMiniType<
 > = z.union([
   ProductPriceCustomCreate$outboundSchema,
   ProductPriceFixedCreate$outboundSchema,
-  ProductPriceFreeCreate$outboundSchema,
   ProductPriceMeteredUnitCreate$outboundSchema,
   ProductPriceSeatBasedCreate$outboundSchema,
 ]);
@@ -167,7 +158,6 @@ export type ProductCreateOneTime$Outbound = {
   prices: Array<
     | ProductPriceCustomCreate$Outbound
     | ProductPriceFixedCreate$Outbound
-    | ProductPriceFreeCreate$Outbound
     | ProductPriceMeteredUnitCreate$Outbound
     | ProductPriceSeatBasedCreate$Outbound
   >;
@@ -199,7 +189,6 @@ export const ProductCreateOneTime$outboundSchema: z.ZodMiniType<
       z.union([
         ProductPriceCustomCreate$outboundSchema,
         ProductPriceFixedCreate$outboundSchema,
-        ProductPriceFreeCreate$outboundSchema,
         ProductPriceMeteredUnitCreate$outboundSchema,
         ProductPriceSeatBasedCreate$outboundSchema,
       ]),

package/src/models/components/productcreaterecurring.ts

@@ -20,11 +20,6 @@ import {
   ProductPriceFixedCreate$Outbound,
   ProductPriceFixedCreate$outboundSchema,
 } from "./productpricefixedcreate.js";
-import {
-  ProductPriceFreeCreate,
-  ProductPriceFreeCreate$Outbound,
-  ProductPriceFreeCreate$outboundSchema,
-} from "./productpricefreecreate.js";
 import {
   ProductPriceMeteredUnitCreate,
   ProductPriceMeteredUnitCreate$Outbound,
@@ -40,9 +35,9 @@ import {
   ProductVisibility$outboundSchema,
 } from "./productvisibility.js";
 import {
-  SubscriptionRecurringInterval,
-  SubscriptionRecurringInterval$outboundSchema,
-} from "./subscriptionrecurringinterval.js";
+  RecurringInterval,
+  RecurringInterval$outboundSchema,
+} from "./recurringinterval.js";
 import {
   TrialInterval,
   TrialInterval$outboundSchema,
@@ -53,7 +48,6 @@ export type ProductCreateRecurringMetadata = string | number | number | boolean;
 export type ProductCreateRecurringPrices =
   | ProductPriceCustomCreate
   | ProductPriceFixedCreate
-  | ProductPriceFreeCreate
   | ProductPriceMeteredUnitCreate
   | ProductPriceSeatBasedCreate;
 
@@ -84,12 +78,11 @@ export type ProductCreateRecurring = {
   description?: string | null | undefined;
   visibility?: ProductVisibility | undefined;
   /**
-   * List of available prices for this product. It should contain at most one static price (fixed, custom or free), and any number of metered prices. Metered prices are not supported on one-time purchase products.
+   * List of available prices for this product. It may combine at most one fixed price with one seat-based price (billed as `fixed + seat_charge`), or contain a single custom or free price, plus any number of metered prices. A free price cannot be combined with other prices, and a custom price cannot be combined with a fixed or seat-based price. Metered prices are not supported on one-time purchase products.
    */
   prices: Array<
     | ProductPriceCustomCreate
     | ProductPriceFixedCreate
-    | ProductPriceFreeCreate
     | ProductPriceMeteredUnitCreate
     | ProductPriceSeatBasedCreate
   >;
@@ -113,11 +106,19 @@ export type ProductCreateRecurring = {
    * The number of interval units for the trial period.
    */
   trialIntervalCount?: number | null | undefined;
-  recurringInterval: SubscriptionRecurringInterval;
+  recurringInterval: RecurringInterval;
   /**
    * Number of interval units of the subscription. If this is set to 1 the charge will happen every interval (e.g. every month), if set to 2 it will be every other month, and so on.
    */
   recurringIntervalCount?: number | undefined;
+  /**
+   * Optional meter cycle, independent of the billing interval. When set, overage settlement, meter resets and meter-credit grants run on this cadence rather than the billing interval — e.g. yearly billing with monthly credits. It must evenly divide the billing interval. If `None`, metered concerns follow the billing interval. **Once set, it can't be changed.**
+   */
+  meterInterval?: RecurringInterval | null | undefined;
+  /**
+   * Number of meter interval units. Defaults to 1 when `meter_interval` is set. Ignored when `meter_interval` is `None`.
+   */
+  meterIntervalCount?: number | null | undefined;
 };
 
 /** @internal */
@@ -147,7 +148,6 @@ export function productCreateRecurringMetadataToJSON(
 export type ProductCreateRecurringPrices$Outbound =
   | ProductPriceCustomCreate$Outbound
   | ProductPriceFixedCreate$Outbound
-  | ProductPriceFreeCreate$Outbound
   | ProductPriceMeteredUnitCreate$Outbound
   | ProductPriceSeatBasedCreate$Outbound;
 
@@ -158,7 +158,6 @@ export const ProductCreateRecurringPrices$outboundSchema: z.ZodMiniType<
 > = z.union([
   ProductPriceCustomCreate$outboundSchema,
   ProductPriceFixedCreate$outboundSchema,
-  ProductPriceFreeCreate$outboundSchema,
   ProductPriceMeteredUnitCreate$outboundSchema,
   ProductPriceSeatBasedCreate$outboundSchema,
 ]);
@@ -182,7 +181,6 @@ export type ProductCreateRecurring$Outbound = {
   prices: Array<
     | ProductPriceCustomCreate$Outbound
     | ProductPriceFixedCreate$Outbound
-    | ProductPriceFreeCreate$Outbound
     | ProductPriceMeteredUnitCreate$Outbound
     | ProductPriceSeatBasedCreate$Outbound
   >;
@@ -195,6 +193,8 @@ export type ProductCreateRecurring$Outbound = {
   trial_interval_count?: number | null | undefined;
   recurring_interval: string;
   recurring_interval_count: number;
+  meter_interval?: string | null | undefined;
+  meter_interval_count?: number | null | undefined;
 };
 
 /** @internal */
@@ -216,7 +216,6 @@ export const ProductCreateRecurring$outboundSchema: z.ZodMiniType<
       z.union([
         ProductPriceCustomCreate$outboundSchema,
         ProductPriceFixedCreate$outboundSchema,
-        ProductPriceFreeCreate$outboundSchema,
         ProductPriceMeteredUnitCreate$outboundSchema,
         ProductPriceSeatBasedCreate$outboundSchema,
       ]),
@@ -228,8 +227,10 @@ export const ProductCreateRecurring$outboundSchema: z.ZodMiniType<
     organizationId: z.optional(z.nullable(z.string())),
     trialInterval: z.optional(z.nullable(TrialInterval$outboundSchema)),
     trialIntervalCount: z.optional(z.nullable(z.int())),
-    recurringInterval: SubscriptionRecurringInterval$outboundSchema,
+    recurringInterval: RecurringInterval$outboundSchema,
     recurringIntervalCount: z._default(z.int(), 1),
+    meterInterval: z.optional(z.nullable(RecurringInterval$outboundSchema)),
+    meterIntervalCount: z.optional(z.nullable(z.int())),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -239,6 +240,8 @@ export const ProductCreateRecurring$outboundSchema: z.ZodMiniType<
       trialIntervalCount: "trial_interval_count",
       recurringInterval: "recurring_interval",
       recurringIntervalCount: "recurring_interval_count",
+      meterInterval: "meter_interval",
+      meterIntervalCount: "meter_interval_count",
     });
   }),
 );

package/src/models/components/productprice.ts

@@ -18,12 +18,6 @@ import {
   ProductPriceFixed$Outbound,
   ProductPriceFixed$outboundSchema,
 } from "./productpricefixed.js";
-import {
-  ProductPriceFree,
-  ProductPriceFree$inboundSchema,
-  ProductPriceFree$Outbound,
-  ProductPriceFree$outboundSchema,
-} from "./productpricefree.js";
 import {
   ProductPriceMeteredUnit,
   ProductPriceMeteredUnit$inboundSchema,
@@ -40,7 +34,6 @@ import {
 export type ProductPrice =
   | ProductPriceCustom
   | ProductPriceFixed
-  | ProductPriceFree
   | ProductPriceMeteredUnit
   | ProductPriceSeatBased;
 
@@ -49,7 +42,6 @@ export const ProductPrice$inboundSchema: z.ZodMiniType<ProductPrice, unknown> =
   z.union([
     ProductPriceCustom$inboundSchema,
     ProductPriceFixed$inboundSchema,
-    ProductPriceFree$inboundSchema,
     ProductPriceMeteredUnit$inboundSchema,
     ProductPriceSeatBased$inboundSchema,
   ]);
@@ -57,7 +49,6 @@ export const ProductPrice$inboundSchema: z.ZodMiniType<ProductPrice, unknown> =
 export type ProductPrice$Outbound =
   | ProductPriceCustom$Outbound
   | ProductPriceFixed$Outbound
-  | ProductPriceFree$Outbound
   | ProductPriceMeteredUnit$Outbound
   | ProductPriceSeatBased$Outbound;
 
@@ -68,7 +59,6 @@ export const ProductPrice$outboundSchema: z.ZodMiniType<
 > = z.union([
   ProductPriceCustom$outboundSchema,
   ProductPriceFixed$outboundSchema,
-  ProductPriceFree$outboundSchema,
   ProductPriceMeteredUnit$outboundSchema,
   ProductPriceSeatBased$outboundSchema,
 ]);

package/src/models/components/productpricefixedcreate.ts

@@ -24,7 +24,7 @@ export type ProductPriceFixedCreate = {
    */
   taxBehavior?: TaxBehaviorOption | null | undefined;
   /**
-   * The price in cents.
+   * The price in cents. Set to `0` for a free price.
    *
    * @remarks
    * Minimum amounts per currency: