orb-billing 5.15.0 → 5.17.0

package/src/resources/shared.ts

@@ -2097,9 +2097,19 @@ export interface InvoiceTiny {
   id: string;
 }
 
+/**
+ * A minimal representation of an Item containing only the essential identifying
+ * information.
+ */
 export interface ItemSlim {
+  /**
+   * The Orb-assigned unique identifier for the item.
+   */
   id: string;
 
+  /**
+   * The name of the item.
+   */
   name: string;
 }
 
@@ -9533,7 +9543,9 @@ export type Price =
   | Price.ScalableMatrixWithUnitPricingPrice
   | Price.ScalableMatrixWithTieredPricingPrice
   | Price.CumulativeGroupedBulkPrice
-  | Price.MinimumCompositePrice;
+  | Price.MinimumCompositePrice
+  | Price.PercentCompositePrice
+  | Price.EventOutputPrice;
 
 export namespace Price {
   export interface UnitPrice {
@@ -9570,6 +9582,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -9659,6 +9675,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -9753,6 +9773,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -9837,6 +9861,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -9926,6 +9954,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10015,6 +10047,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10139,6 +10175,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10265,6 +10305,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10404,6 +10448,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10523,6 +10571,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10652,6 +10704,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10763,6 +10819,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10869,6 +10929,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -10958,6 +11022,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11077,6 +11145,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11183,6 +11255,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11294,6 +11370,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11412,6 +11492,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11523,6 +11607,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11683,6 +11771,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11794,6 +11886,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -11927,6 +12023,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12051,6 +12151,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12179,6 +12283,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12322,6 +12430,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12480,6 +12592,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12603,6 +12719,10 @@ export namespace Price {
 
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
     item: Shared.ItemSlim;
 
     /**
@@ -12674,6 +12794,222 @@ export namespace Price {
       prorated?: boolean;
     }
   }
+
+  export interface PercentCompositePrice {
+    id: string;
+
+    billable_metric: Shared.BillableMetricTiny | null;
+
+    billing_cycle_configuration: Shared.BillingCycleConfiguration;
+
+    billing_mode: 'in_advance' | 'in_arrear';
+
+    cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+    composite_price_filters: Array<Shared.TransformPriceFilter> | null;
+
+    conversion_rate: number | null;
+
+    conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+    created_at: string;
+
+    credit_allocation: Shared.Allocation | null;
+
+    currency: string;
+
+    /**
+     * @deprecated
+     */
+    discount: Shared.Discount | null;
+
+    external_price_id: string | null;
+
+    fixed_price_quantity: number | null;
+
+    invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
+    item: Shared.ItemSlim;
+
+    /**
+     * @deprecated
+     */
+    maximum: Shared.Maximum | null;
+
+    /**
+     * @deprecated
+     */
+    maximum_amount: string | null;
+
+    /**
+     * User specified key-value pairs for the resource. If not present, this defaults
+     * to an empty dictionary. Individual keys can be removed by setting the value to
+     * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+     * `null`.
+     */
+    metadata: { [key: string]: string };
+
+    /**
+     * @deprecated
+     */
+    minimum: Shared.Minimum | null;
+
+    /**
+     * @deprecated
+     */
+    minimum_amount: string | null;
+
+    /**
+     * The pricing model type
+     */
+    model_type: 'percent';
+
+    name: string;
+
+    /**
+     * Configuration for percent pricing
+     */
+    percent_config: PercentCompositePrice.PercentConfig;
+
+    plan_phase_order: number | null;
+
+    price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+
+    /**
+     * The price id this price replaces. This price will take the place of the replaced
+     * price in plan version migrations.
+     */
+    replaces_price_id: string | null;
+
+    dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+  }
+
+  export namespace PercentCompositePrice {
+    /**
+     * Configuration for percent pricing
+     */
+    export interface PercentConfig {
+      /**
+       * What percent of the component subtotals to charge
+       */
+      percent: number;
+    }
+  }
+
+  export interface EventOutputPrice {
+    id: string;
+
+    billable_metric: Shared.BillableMetricTiny | null;
+
+    billing_cycle_configuration: Shared.BillingCycleConfiguration;
+
+    billing_mode: 'in_advance' | 'in_arrear';
+
+    cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+    composite_price_filters: Array<Shared.TransformPriceFilter> | null;
+
+    conversion_rate: number | null;
+
+    conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+    created_at: string;
+
+    credit_allocation: Shared.Allocation | null;
+
+    currency: string;
+
+    /**
+     * @deprecated
+     */
+    discount: Shared.Discount | null;
+
+    /**
+     * Configuration for event_output pricing
+     */
+    event_output_config: EventOutputPrice.EventOutputConfig;
+
+    external_price_id: string | null;
+
+    fixed_price_quantity: number | null;
+
+    invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
+    item: Shared.ItemSlim;
+
+    /**
+     * @deprecated
+     */
+    maximum: Shared.Maximum | null;
+
+    /**
+     * @deprecated
+     */
+    maximum_amount: string | null;
+
+    /**
+     * User specified key-value pairs for the resource. If not present, this defaults
+     * to an empty dictionary. Individual keys can be removed by setting the value to
+     * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+     * `null`.
+     */
+    metadata: { [key: string]: string };
+
+    /**
+     * @deprecated
+     */
+    minimum: Shared.Minimum | null;
+
+    /**
+     * @deprecated
+     */
+    minimum_amount: string | null;
+
+    /**
+     * The pricing model type
+     */
+    model_type: 'event_output';
+
+    name: string;
+
+    plan_phase_order: number | null;
+
+    price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+
+    /**
+     * The price id this price replaces. This price will take the place of the replaced
+     * price in plan version migrations.
+     */
+    replaces_price_id: string | null;
+
+    dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+  }
+
+  export namespace EventOutputPrice {
+    /**
+     * Configuration for event_output pricing
+     */
+    export interface EventOutputConfig {
+      /**
+       * The key in the event data to extract the unit rate from.
+       */
+      unit_rating_key: string;
+
+      /**
+       * An optional key in the event data to group by (e.g., event ID). All events will
+       * also be grouped by their unit rate.
+       */
+      grouping_key?: string | null;
+    }
+  }
 }
 
 /**