lago-javascript-client 1.47.0 → 1.48.0

package/esm/openapi/webhooks.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/esm/webhook_types.d.ts

@@ -0,0 +1,68 @@
+import type { webhooks } from "./openapi/webhooks.js";
+/** Extract the `application/json` body of a webhook's POST request. */
+type _PayloadOf<K extends keyof webhooks> = webhooks[K] extends {
+    post: {
+        requestBody?: {
+            content: {
+                "application/json": infer P;
+            };
+        };
+    };
+} ? P : never;
+/** Extract the `webhook_type` literal (e.g. `"alert.triggered"`) from a payload. */
+type _WebhookTypeOf<K extends keyof webhooks> = _PayloadOf<K> extends {
+    webhook_type: infer T;
+} ? T extends string ? T : never : never;
+/**
+ * Map of webhook event name to its typed payload.
+ *
+ * @example
+ * ```ts
+ * import type { LagoWebhookPayloads } from "lago-javascript-client";
+ *
+ * app.post("/webhooks", (req, res) => {
+ *   const event = req.body as LagoWebhookPayloads["alert.triggered"];
+ *   console.log(event.triggered_alert.external_customer_id);
+ * });
+ * ```
+ */
+export type LagoWebhookPayloads = {
+    [K in keyof webhooks as _WebhookTypeOf<K>]: _PayloadOf<K>;
+};
+/**
+ * Discriminated union of every webhook payload. Narrow with the `webhook_type`
+ * field in a `switch` to get a fully typed branch.
+ *
+ * @example
+ * ```ts
+ * import type { LagoWebhookPayload } from "lago-javascript-client";
+ *
+ * function handle(event: LagoWebhookPayload) {
+ *   switch (event.webhook_type) {
+ *     case "alert.triggered":
+ *       // event is narrowed; event.triggered_alert is fully typed
+ *       break;
+ *     case "invoice.created":
+ *       // event.invoice is fully typed
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type LagoWebhookPayload = LagoWebhookPayloads[keyof LagoWebhookPayloads];
+/**
+ * Union of every `webhook_type` string emitted by Lago, e.g.
+ * `"alert.triggered" | "invoice.created" | ...`.
+ */
+export type LagoWebhookType = keyof LagoWebhookPayloads;
+/**
+ * Helper to look up a single payload type by its `webhook_type` string.
+ *
+ * @example
+ * ```ts
+ * import type { WebhookOf } from "lago-javascript-client";
+ * type InvoiceCreated = WebhookOf<"invoice.created">;
+ * ```
+ */
+export type WebhookOf<T extends LagoWebhookType> = LagoWebhookPayloads[T];
+export {};

package/esm/webhook_types.js

@@ -0,0 +1,23 @@
+// User-facing TypeScript types for Lago webhook payloads.
+//
+// Backed by ./openapi/webhooks.ts, which is auto-generated from the Lago
+// OpenAPI 3.1 spec (`webhooks:` key) via `deno task generate:webhooks`.
+// This file is hand-written and is safe across regenerations.
+//
+// The generator output keys events by their snake_case operationId
+// (e.g. `alert_triggered`). We re-key here by the dotted `webhook_type`
+// literal (e.g. `alert.triggered`) so that the public API matches the
+// string customers actually see on the wire.
+//
+// Note on nested types: the payload types here are produced by
+// `openapi-typescript`, while the SDK's component exports (e.g.
+// `CustomerObject`, `InvoiceObjectExtended`) are produced by
+// `swagger-typescript-api`. The two generators interpret the same schema
+// slightly differently for nullable fields, so a value typed as
+// `LagoWebhookPayloads['customer.created']['customer']` is not always
+// structurally equal to `CustomerObject` from the main SDK exports. Both
+// are valid views of the same wire shape; the openapi-typescript view is
+// the more accurate one for what actually arrives over the network. If
+// you pass webhook objects into helpers typed with SDK components, a
+// narrowing cast may be required.
+export {};

package/package.json

@@ -3,7 +3,7 @@
   "main": "./script/mod.js",
   "name": "lago-javascript-client",
   "sideEffects": false,
-  "version": "v1.47.0",
+  "version": "v1.48.0",
   "description": "Lago JavaScript API Client",
   "repository": {
     "type": "git",

package/script/mod.d.ts

@@ -14,3 +14,4 @@ export { parseRateLimitHeaders, parseRateLimitInfo, type RateLimitHeaders, type
 export { createRateLimitFetch, type RateLimitFetchConfig, type RateLimitInfoCallback, } from "./rate_limit_fetch.js";
 export { DEFAULT_RATE_LIMIT_THRESHOLDS, loggingRateLimitObserver, type LoggingRateLimitObserverOptions, } from "./logging_rate_limit_observer.js";
 export * from "./openapi/client.js";
+export type { LagoWebhookPayload, LagoWebhookPayloads, LagoWebhookType, WebhookOf, } from "./webhook_types.js";

package/script/openapi/client.d.ts

@@ -2030,6 +2030,16 @@ export interface PricingUnitDetailsObject {
      */
     conversion_rate: string;
 }
+/** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+export type PresentationBreakdownsObject = {
+    /** Key value list of event properties used for presentation grouping. */
+    presentation_by?: Record<string, string>;
+    /**
+     * The number of units consumed for a specific presentation group.
+     * @example "9.0"
+     */
+    units?: string;
+}[];
 export interface FeeObject {
     /**
      * Unique identifier assigned to the fee within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the fee's record within the Lago system.
@@ -2313,6 +2323,8 @@ export interface FeeObject {
     applied_taxes?: FeeAppliedTaxObject[];
     /** Details about the pricing unit used and amounts for this fee. */
     pricing_unit_details?: object | null;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
 }
 export interface CreditNoteItemObject {
     /**
@@ -3505,54 +3517,6 @@ export interface InvoiceBaseObject {
      */
     updated_at: string;
 }
-export interface BillingPeriodObject {
-    /**
-     * Unique identifier assigned to the subscription, created by Lago.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_subscription_id: string;
-    /**
-     * Unique identifier assigned to the subscription in your application.
-     * @example "external_id"
-     */
-    external_subscription_id: string;
-    /**
-     * Unique identifier assigned to the plan, created by Lago.
-     * @format uuid
-     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
-     */
-    lago_plan_id: string;
-    /**
-     * The beginning date of the subscription billing period. This field indicates the start date of the billing period associated with the subscription fee.
-     * @format date-time
-     * @example "2022-04-29T08:59:51Z"
-     */
-    subscription_from_datetime: string;
-    /**
-     * The ending date of the subscription billing period. This field indicates the end date of the billing period associated with the subscription fee.
-     * @format date-time
-     * @example "2022-05-29T08:59:51Z"
-     */
-    subscription_to_datetime: string;
-    /**
-     * The beginning date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the start date of the billing period or subscription period associated with the fees.
-     * @format date-time
-     * @example "2022-04-29T08:59:51Z"
-     */
-    charges_from_datetime: string;
-    /**
-     * The ending date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the end date of the billing period or subscription period associated with the fees.
-     * @format date-time
-     * @example "2022-05-29T08:59:51Z"
-     */
-    charges_to_datetime: string;
-    /**
-     * The reason explaining why this subscription appears on the invoice.
-     * @example "subscription_starting"
-     */
-    invoicing_reason: "subscription_starting" | "subscription_periodic" | "subscription_terminating" | "in_advance_charge" | "in_advance_charge_periodic" | "progressive_billing";
-}
 export interface InvoiceMetadataObject {
     /**
      * Unique identifier assigned to the invoice metadata within the Lago application.
@@ -3677,7 +3641,6 @@ export interface AppliedUsageThresholdObject {
 export type InvoiceObject = InvoiceBaseObject & {
     /** The customer on which the invoice applies. It refers to the customer account or entity associated with the invoice. */
     customer?: CustomerObject;
-    billing_periods?: BillingPeriodObject[];
     metadata?: InvoiceMetadataObject[];
     applied_taxes?: InvoiceAppliedTaxObject[];
     /** The invoice custom sections applied to this invoice for PDF generation. */
@@ -4030,6 +3993,15 @@ export interface SubscriptionObject {
     applied_invoice_custom_sections?: AppliedInvoiceCustomSectionObject[];
     /** The payment method assigned to this subscription for processing payments. */
     payment_method?: PaymentMethodReference;
+    /**
+     * Controls whether this subscription is eligible to be grouped with other subscriptions of the same customer on a consolidated recurring invoice.
+     *
+     * - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+     * - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice, regardless of other grouping criteria.
+     * @default true
+     * @example true
+     */
+    consolidate_invoice?: boolean;
 }
 export interface SubscriptionsPaginated {
     subscriptions: SubscriptionObject[];
@@ -4784,6 +4756,8 @@ export type CustomerChargeFiltersUsageObject = {
      * @example {"region":["us-east-1"]}
      */
     values?: Record<string, string[]>;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
 }[];
 /** Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
 export type CustomerChargeGroupedUsageObject = {
@@ -4815,6 +4789,8 @@ export type CustomerChargeGroupedUsageObject = {
     grouped_by?: Record<string, string>;
     /** Array of filter object, representing multiple dimensions for a charge item. */
     filters?: CustomerChargeFiltersUsageObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
 }[];
 export interface CustomerChargeUsageObject {
     /**
@@ -4863,7 +4839,7 @@ export interface CustomerChargeUsageObject {
          * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
          * @example "Setup"
          */
-        invoice_display_name?: string;
+        invoice_display_name?: string | null;
     };
     /** The related billable metric object. */
     billable_metric: {
@@ -4893,6 +4869,8 @@ export interface CustomerChargeUsageObject {
     filters?: CustomerChargeFiltersUsageObject;
     /** Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
     grouped_usage?: CustomerChargeGroupedUsageObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
 }
 export interface CustomerUsageObject {
     /**
@@ -4945,6 +4923,179 @@ export interface CustomerUsageObject {
 export interface CustomerUsage {
     customer_usage: CustomerUsageObject;
 }
+/** Array of filter object, representing multiple dimensions for a charge item. */
+export type CustomerProjectedChargeFiltersUsageObject = {
+    /**
+     * The number of units consumed for a specific charge filter related to a charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "0.9"
+     */
+    units?: string;
+    /**
+     * The projected number of units that can be consumed for a specific charge filter related to a charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.8"
+     */
+    projected_units?: string;
+    /**
+     * The amount in cents, tax excluded, consumed for a specific charge filter related to a charge item.
+     * @example 1000
+     */
+    amount_cents?: number;
+    /**
+     * The projected amount in cents, tax excluded, that can be consumed for a specific charge filter related to a charge item.
+     * @example 2000
+     */
+    projected_amount_cents?: number;
+    /**
+     * The quantity of usage events that have been recorded for a particular charge filter during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+     * @example 10
+     */
+    events_count?: number;
+    /**
+     * Specifies the name that will be displayed on an invoice.
+     * @example "AWS eu-east-1"
+     */
+    invoice_display_name?: string;
+    /** Details about the pricing unit used for charge usage. */
+    pricing_unit_details?: UsagePricingUnitDetailsObject;
+    /**
+     * List of filter values applied to the usage.
+     * @example {"region":["us-east-1"]}
+     */
+    values?: Record<string, string[]>;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    projected_presentation_breakdowns?: PresentationBreakdownsObject;
+}[];
+/** Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
+export type CustomerProjectedChargeGroupedUsageObject = {
+    /**
+     * The amount in cents, tax excluded, consumed for a specific group related to a charge item.
+     * @example 1000
+     */
+    amount_cents?: number;
+    /**
+     * The projected amount in cents, tax excluded, that can be consumed for a specific group related to a charge item.
+     * @example 2000
+     */
+    projected_amount_cents?: number;
+    /**
+     * The quantity of usage events that have been recorded for a particular charge during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+     * @example 10
+     */
+    events_count?: number;
+    /**
+     * The number of units consumed for a specific group related to a charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "0.9"
+     */
+    units?: string;
+    /**
+     * The projected number of units that can be consumed for a specific group related to a charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.8"
+     */
+    projected_units?: string;
+    /** Details about the pricing unit used for charge usage. */
+    pricing_unit_details?: UsagePricingUnitDetailsObject;
+    /** Key value list of event properties aggregated by the charge model */
+    grouped_by?: Record<string, string>;
+    /** Array of filter object, representing multiple dimensions for a charge item. */
+    filters?: CustomerProjectedChargeFiltersUsageObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    projected_presentation_breakdowns?: PresentationBreakdownsObject;
+}[];
+export interface CustomerProjectedChargeUsageObject {
+    /**
+     * The number of units consumed by the customer for a specific charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "1.0"
+     */
+    units: string;
+    /**
+     * The projected number of units that can be consumed by the customer for a specific charge item.
+     * @pattern ^[0-9]+.?[0-9]*$
+     * @example "2.0"
+     */
+    projected_units: string;
+    /**
+     * The quantity of usage events that have been recorded for a particular charge during the specified time period. These events may also be referred to as the number of transactions in some contexts.
+     * @example 10
+     */
+    events_count: number;
+    /**
+     * The amount in cents, tax excluded, consumed by the customer for a specific charge item.
+     * @example 123
+     */
+    amount_cents: number;
+    /**
+     * The projected amount in cents, tax excluded, that can be consumed by the customer for a specific charge item.
+     * @example 256
+     */
+    projected_amount_cents: number;
+    /**
+     * The currency of a usage item consumed by the customer.
+     * @example "EUR"
+     */
+    amount_currency: Currency;
+    /** Details about the pricing unit used for charge usage. */
+    pricing_unit_details?: UsagePricingUnitDetailsObject;
+    /** Object listing all the properties for a specific charge item. */
+    charge: {
+        /**
+         * Unique identifier assigned to the charge within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the charge's record within the Lago system.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        lago_id: string;
+        /**
+         * The pricing model applied to this charge. Possible values are standard, `graduated`, `percentage`, `package` or `volume`.
+         * @example "graduated"
+         */
+        charge_model: "standard" | "graduated" | "package" | "percentage" | "volume";
+        /**
+         * Specifies the name that will be displayed on an invoice. If no value is set for this field, the name of the actual charge will be used as the default display name.
+         * @example "Setup"
+         */
+        invoice_display_name?: string;
+    };
+    /** The related billable metric object. */
+    billable_metric: {
+        /**
+         * Unique identifier assigned to the billable metric within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the billable metric's record within the Lago system.
+         * @format uuid
+         * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+         */
+        lago_id: string;
+        /**
+         * The name of the billable metric used for this charge.
+         * @example "Storage"
+         */
+        name: string;
+        /**
+         * The code of the billable metric used for this charge.
+         * @example "storage"
+         */
+        code: string;
+        /**
+         * The aggregation type of the billable metric used for this charge. Possible values are `count_agg`, `sum_agg`, `max_agg` or `unique_count_agg`.
+         * @example "sum_agg"
+         */
+        aggregation_type: "count_agg" | "sum_agg" | "max_agg" | "unique_count_agg" | "weighted_sum_agg" | "latest_agg";
+    };
+    /** Array of filter object, representing multiple dimensions for a charge item. */
+    filters?: CustomerProjectedChargeFiltersUsageObject;
+    /** Array of aggregated fees, grouped by the event properties defined in a `standard` charge model. */
+    grouped_usage?: CustomerProjectedChargeGroupedUsageObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    presentation_breakdowns?: PresentationBreakdownsObject;
+    /** Array of usage breakdowns split by presentation group keys without affecting pricing or aggregation. */
+    projected_presentation_breakdowns?: PresentationBreakdownsObject;
+}
 export interface CustomerProjectedUsageObject {
     /**
      * The lower bound of the billing period, expressed in the ISO 8601 datetime format in Coordinated Universal Time (UTC).
@@ -4996,13 +5147,13 @@ export interface CustomerProjectedUsageObject {
      */
     total_amount_cents: number;
     /** Array of charges that comprise the current usage. It contains detailed information about individual charge items associated with the usage. */
-    charges_usage: CustomerChargeUsageObject[];
+    charges_usage: CustomerProjectedChargeUsageObject[];
 }
 export interface CustomerProjectedUsage {
     customer_projected_usage: CustomerProjectedUsageObject;
 }
 export interface CustomerPastUsage {
-    usage_periods: CustomerUsage[];
+    usage_periods: CustomerUsageObject[];
     meta: PaginationMeta;
 }
 export interface CustomerCheckoutUrl {
@@ -5516,7 +5667,56 @@ export interface InvoiceOneOffCreateInput {
         payment_method?: PaymentMethodReference;
     };
 }
+export interface BillingPeriodObject {
+    /**
+     * Unique identifier assigned to the subscription, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_subscription_id: string;
+    /**
+     * Unique identifier assigned to the subscription in your application.
+     * @example "external_id"
+     */
+    external_subscription_id: string;
+    /**
+     * Unique identifier assigned to the plan, created by Lago.
+     * @format uuid
+     * @example "1a901a90-1a90-1a90-1a90-1a901a901a90"
+     */
+    lago_plan_id: string;
+    /**
+     * The beginning date of the subscription billing period. This field indicates the start date of the billing period associated with the subscription fee.
+     * @format date-time
+     * @example "2022-04-29T08:59:51Z"
+     */
+    subscription_from_datetime: string;
+    /**
+     * The ending date of the subscription billing period. This field indicates the end date of the billing period associated with the subscription fee.
+     * @format date-time
+     * @example "2022-05-29T08:59:51Z"
+     */
+    subscription_to_datetime: string;
+    /**
+     * The beginning date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the start date of the billing period or subscription period associated with the fees.
+     * @format date-time
+     * @example "2022-04-29T08:59:51Z"
+     */
+    charges_from_datetime: string;
+    /**
+     * The ending date of the period that covers the charge fees. It is applicable only to the `charge` fees attached to the subscription. This field indicates the end date of the billing period or subscription period associated with the fees.
+     * @format date-time
+     * @example "2022-05-29T08:59:51Z"
+     */
+    charges_to_datetime: string;
+    /**
+     * The reason explaining why this subscription appears on the invoice.
+     * @example "subscription_starting"
+     */
+    invoicing_reason: "subscription_starting" | "subscription_periodic" | "subscription_terminating" | "in_advance_charge" | "in_advance_charge_periodic" | "progressive_billing";
+}
 export type InvoiceObjectExtended = InvoiceObject & {
+    billing_periods?: BillingPeriodObject[];
     credits?: CreditObject[];
     fees?: FeeObject[];
     subscriptions?: SubscriptionObject[];
@@ -5981,6 +6181,8 @@ export interface OrganizationObject {
      * @example false
      */
     finalize_zero_amount_invoice?: boolean;
+    /** @example "clickhouse" */
+    events_store?: "clickhouse" | "postgres";
 }
 export interface Organization {
     organization: OrganizationObject;
@@ -6262,6 +6464,23 @@ export interface ChargeProperties {
         per_unit_amount: string;
     }[];
 }
+export type ChargeObjectProperties = ChargeProperties & {
+    /**
+     * Groups usage into sub-items on invoices for display only, without affecting pricing or aggregation.
+     * @example [{"value":"region","options":{"display_in_invoice":true}}]
+     */
+    presentation_group_keys?: {
+        /**
+         * The event property to group by.
+         * @example "region"
+         */
+        value?: string;
+        options?: {
+            /** @example true */
+            display_in_invoice?: boolean;
+        };
+    }[];
+};
 /** Values used to apply differentiated pricing based on additional event properties. */
 export interface ChargeFilterObject {
     /**
@@ -6356,7 +6575,7 @@ export interface ChargeObject {
      */
     min_amount_cents: number;
     /** List of all thresholds utilized for calculating the charge. */
-    properties: ChargeProperties;
+    properties: ChargeObjectProperties;
     /** List of filters used to apply differentiated pricing based on additional event properties. */
     filters: ChargeFilterObject[];
     /** All taxes applied to the charge. */
@@ -6820,7 +7039,7 @@ export interface PlanCreateInput {
              */
             min_amount_cents?: number;
             /** List of all thresholds utilized for calculating the charge. */
-            properties?: ChargeProperties;
+            properties?: ChargeObjectProperties;
             /** List of filters used to apply differentiated pricing based on additional event properties. */
             filters?: ChargeFilterInput[];
             /** List of unique code used to identify the taxes. */
@@ -7043,7 +7262,7 @@ export interface PlanUpdateInput {
              */
             min_amount_cents?: number;
             /** List of all thresholds utilized for calculating the charge. */
-            properties?: ChargeProperties;
+            properties?: ChargeObjectProperties;
             /** List of filters used to apply differentiated pricing based on additional event properties. */
             filters?: ChargeFilterInput[];
             /** List of unique code used to identify the taxes. */
@@ -7175,7 +7394,7 @@ export interface ChargeOverridableInput {
      */
     min_amount_cents?: number;
     /** List of all thresholds utilized for calculating the charge. */
-    properties?: ChargeProperties;
+    properties?: ChargeObjectProperties;
     /** List of filters used to apply differentiated pricing based on additional event properties. */
     filters?: ChargeFilterInput[];
     /** List of unique code used to identify the taxes. */
@@ -7541,7 +7760,7 @@ export interface PlanOverridesObject {
          */
         min_amount_cents?: number;
         /** List of all thresholds utilized for calculating the charge. */
-        properties?: ChargeProperties;
+        properties?: ChargeObjectProperties;
         /** List of filters used to apply differentiated pricing based on additional event properties. */
         filters?: ChargeFilterInput[];
         /** List of unique code used to identify the taxes. */
@@ -7662,6 +7881,15 @@ export interface SubscriptionCreateInput {
         invoice_custom_section?: InvoiceCustomSectionInput;
         /** Optional payment method to use for processing subscription payments. */
         payment_method?: PaymentMethodReference;
+        /**
+         * Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+         *
+         * - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+         * - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.
+         * @default true
+         * @example true
+         */
+        consolidate_invoice?: boolean;
     };
 }
 export interface ApplicableUsageThreshold {
@@ -7719,6 +7947,14 @@ export interface SubscriptionUpdateInput {
         invoice_custom_section?: InvoiceCustomSectionInput;
         /** Optional payment method to use for processing subscription payments. */
         payment_method?: PaymentMethodReference;
+        /**
+         * Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+         *
+         * - `true`: the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+         * - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.
+         * @example false
+         */
+        consolidate_invoice?: boolean;
     };
 }
 export interface Subscription {
@@ -8857,7 +9093,7 @@ export declare class HttpClient<SecurityDataType = unknown> {
 }
 /**
  * @title Lago API documentation
- * @version 1.45.2
+ * @version 1.48.0
  * @license AGPLv3 (https://github.com/getlago/lago-openapi/blob/main/LICENSE)
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago
@@ -10348,6 +10584,11 @@ export declare class Api<SecurityDataType extends unknown> extends HttpClient<Se
              * @example true
              */
             full_usage?: boolean;
+            /**
+             * Filter `presentation_breakdowns` by a JSON-encoded array of presentation group key values. Only breakdowns matching the provided values will be returned. Pass an empty array to disable `presentation_breakdowns` entirely.
+             * @example "["engineering", "operations"]"
+             */
+            filter_by_presentation?: string;
         }, params?: RequestParams) => Promise<HttpResponse<CustomerUsage, ApiErrorUnauthorized | ApiErrorNotFound>>;
         /**
          * @description This endpoint enables the retrieval of the usage-based billing data for a customer within the current period. It also returns the projected usage for the current period based on the current usage.

package/script/openapi/client.js

@@ -152,7 +152,7 @@ class HttpClient {
 exports.HttpClient = HttpClient;
 /**
  * @title Lago API documentation
- * @version 1.45.2
+ * @version 1.48.0
  * @license AGPLv3 (https://github.com/getlago/lago-openapi/blob/main/LICENSE)
  * @baseUrl https://api.getlago.com/api/v1
  * @externalDocs https://github.com/getlago