@flexprice/sdk 2.1.6 → 2.1.9

package/FUNCTIONS.md

@@ -1,11 +1,11 @@
 # Standalone Functions
 
 > [!NOTE]
-> This section is useful if you are using a bundler and targetting browsers and
+> This section is useful if you are using a bundler and targeting browsers and
 > runtimes where the size of an application affects performance and load times. 
 
 Every method in this SDK is also available as a standalone function. This
-alternative API is suitable when targetting the browser or serverless runtimes
+alternative API is suitable when targeting the browser or serverless runtimes
 and using a bundler to build your application since all unused functionality
 will be tree-shaken away. This includes code for unused methods, Zod schemas,
 encoding helpers and response handlers. The result is dramatically smaller

package/docs/sdk/models/customer-filter.md

@@ -20,6 +20,7 @@ let value: CustomerFilter = {};
 | `externalIds`                                                                                 | *string*[]                                                                                    | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `filters`                                                                                     | [models.FilterCondition](../../sdk/models/filter-condition.md)[]                              | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `limit`                                                                                       | *number*                                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
+| `metadata`                                                                                    | Record<string, *string*>                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `offset`                                                                                      | *number*                                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `order`                                                                                       | [models.CustomerFilterOrder](../../sdk/models/customer-filter-order.md)                       | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `sort`                                                                                        | [models.SortCondition](../../sdk/models/sort-condition.md)[]                                  | :heavy_minus_sign:                                                                            | N/A                                                                                           |

package/docs/sdk/models/execute-subscription-modify-request.md

@@ -6,14 +6,15 @@
 import { ExecuteSubscriptionModifyRequest } from "@flexprice/sdk/sdk/models";
 
 let value: ExecuteSubscriptionModifyRequest = {
-  type: "quantity_change",
+  type: "grouped_invoicing",
 };
 ```
 
 ## Fields
 
-| Field                                                                                           | Type                                                                                            | Required                                                                                        | Description                                                                                     |
-| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| `inheritanceParams`                                                                             | [models.SubModifyInheritanceRequest](../../sdk/models/sub-modify-inheritance-request.md)        | :heavy_minus_sign:                                                                              | N/A                                                                                             |
-| `quantityChangeParams`                                                                          | [models.SubModifyQuantityChangeRequest](../../sdk/models/sub-modify-quantity-change-request.md) | :heavy_minus_sign:                                                                              | N/A                                                                                             |
-| `type`                                                                                          | [models.SubscriptionModifyType](../../sdk/models/subscription-modify-type.md)                   | :heavy_check_mark:                                                                              | N/A                                                                                             |
+| Field                                                                                             | Type                                                                                              | Required                                                                                          | Description                                                                                       |
+| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `groupedInvoicingParams`                                                                          | [models.SubModifyGroupedInvoicingParams](../../sdk/models/sub-modify-grouped-invoicing-params.md) | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `inheritanceParams`                                                                               | [models.SubModifyInheritanceRequest](../../sdk/models/sub-modify-inheritance-request.md)          | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `quantityChangeParams`                                                                            | [models.SubModifyQuantityChangeRequest](../../sdk/models/sub-modify-quantity-change-request.md)   | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `type`                                                                                            | [models.SubscriptionModifyType](../../sdk/models/subscription-modify-type.md)                     | :heavy_check_mark:                                                                                | N/A                                                                                               |

package/docs/sdk/models/export-metadata-entity-type.md

@@ -0,0 +1,17 @@
+# ExportMetadataEntityType
+
+## Example Usage
+
+```typescript
+import { ExportMetadataEntityType } from "@flexprice/sdk/sdk/models";
+
+let value: ExportMetadataEntityType = "wallet";
+
+// Open enum: unrecognized values are captured as Unrecognized<string>
+```
+
+## Values
+
+```typescript
+"customer" | "wallet" | Unrecognized<string>
+```

package/docs/sdk/models/export-metadata-field.md

@@ -0,0 +1,20 @@
+# ExportMetadataField
+
+## Example Usage
+
+```typescript
+import { ExportMetadataField } from "@flexprice/sdk/sdk/models";
+
+let value: ExportMetadataField = {
+  entityType: "customer",
+  fieldKey: "<value>",
+};
+```
+
+## Fields
+
+| Field                                                                              | Type                                                                               | Required                                                                           | Description                                                                        |
+| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `columnName`                                                                       | *string*                                                                           | :heavy_minus_sign:                                                                 | CSV column header to be shown in the exported file                                 |
+| `entityType`                                                                       | [models.ExportMetadataEntityType](../../sdk/models/export-metadata-entity-type.md) | :heavy_check_mark:                                                                 | N/A                                                                                |
+| `fieldKey`                                                                         | *string*                                                                           | :heavy_check_mark:                                                                 | metadata key to look up                                                            |

package/docs/sdk/models/grouped-invoicing-action.md

@@ -0,0 +1,15 @@
+# GroupedInvoicingAction
+
+## Example Usage
+
+```typescript
+import { GroupedInvoicingAction } from "@flexprice/sdk/sdk/models";
+
+let value: GroupedInvoicingAction = "remove";
+```
+
+## Values
+
+```typescript
+"add" | "remove"
+```

package/docs/sdk/models/invoice-billing-reason.md

@@ -11,5 +11,5 @@ let value: InvoiceBillingReason = "SUBSCRIPTION_CYCLE";
 ## Values
 
 ```typescript
-"SUBSCRIPTION_CREATE" | "SUBSCRIPTION_CYCLE" | "SUBSCRIPTION_UPDATE" | "SUBSCRIPTION_TRIAL_END" | "PRORATION" | "MANUAL"
+"SUBSCRIPTION_CREATE" | "SUBSCRIPTION_CYCLE" | "SUBSCRIPTION_UPDATE" | "SUBSCRIPTION_TRIAL_END" | "SUBSCRIPTION_TRIAL_START" | "PRORATION" | "MANUAL"
 ```

package/docs/sdk/models/list-subscription-line-items-response.md

@@ -0,0 +1,50 @@
+# ListSubscriptionLineItemsResponse
+
+## Example Usage
+
+```typescript
+import { ListSubscriptionLineItemsResponse } from "@flexprice/sdk/sdk/models";
+
+let value: ListSubscriptionLineItemsResponse = {
+  items: [
+    {
+      price: {
+        addon: {
+          prices: [
+            {
+              addon: {},
+              meter: {
+                createdAt: new Date("2024-03-20T15:04:05Z"),
+                eventName: "api_request",
+                id: "550e8400-e29b-41d4-a716-446655440000",
+                name: "API Usage Meter",
+                status: "published",
+                tenantId: "tenant123",
+                updatedAt: new Date("2024-03-20T15:04:05Z"),
+              },
+              plan: {},
+            },
+          ],
+        },
+        meter: {
+          createdAt: new Date("2024-03-20T15:04:05Z"),
+          eventName: "api_request",
+          id: "550e8400-e29b-41d4-a716-446655440000",
+          name: "API Usage Meter",
+          status: "published",
+          tenantId: "tenant123",
+          updatedAt: new Date("2024-03-20T15:04:05Z"),
+        },
+        plan: {},
+      },
+    },
+  ],
+};
+```
+
+## Fields
+
+| Field                                                                                        | Type                                                                                         | Required                                                                                     | Description                                                                                  |
+| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `items`                                                                                      | [models.SubscriptionLineItemResponse](../../sdk/models/subscription-line-item-response.md)[] | :heavy_minus_sign:                                                                           | N/A                                                                                          |
+| `pagination`                                                                                 | [models.PaginationResponse](../../sdk/models/pagination-response.md)                         | :heavy_minus_sign:                                                                           | N/A                                                                                          |

package/docs/sdk/models/plan-filter.md

@@ -17,6 +17,7 @@ let value: PlanFilter = {};
 | `filters`                                                                                     | [models.FilterCondition](../../sdk/models/filter-condition.md)[]                              | :heavy_minus_sign:                                                                            | filters allows complex filtering based on multiple fields                                     |
 | `limit`                                                                                       | *number*                                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `lookupKey`                                                                                   | *string*                                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
+| `metadata`                                                                                    | Record<string, *string*>                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `offset`                                                                                      | *number*                                                                                      | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `order`                                                                                       | [models.PlanFilterOrder](../../sdk/models/plan-filter-order.md)                               | :heavy_minus_sign:                                                                            | N/A                                                                                           |
 | `planIds`                                                                                     | *string*[]                                                                                    | :heavy_minus_sign:                                                                            | N/A                                                                                           |

package/docs/sdk/models/s3-job-config.md

@@ -10,12 +10,13 @@ let value: S3JobConfig = {};
 
 ## Fields
 
-| Field                                                                          | Type                                                                           | Required                                                                       | Description                                                                    |
-| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
-| `bucket`                                                                       | *string*                                                                       | :heavy_minus_sign:                                                             | S3 bucket name                                                                 |
-| `compression`                                                                  | [models.S3CompressionType](../../sdk/models/s3-compression-type.md)            | :heavy_minus_sign:                                                             | N/A                                                                            |
-| `encryption`                                                                   | [models.S3EncryptionType](../../sdk/models/s3-encryption-type.md)              | :heavy_minus_sign:                                                             | N/A                                                                            |
-| `endpointUrl`                                                                  | *string*                                                                       | :heavy_minus_sign:                                                             | Custom S3 endpoint URL (e.g., "http://minio:9000" for MinIO)                   |
-| `keyPrefix`                                                                    | *string*                                                                       | :heavy_minus_sign:                                                             | Optional prefix for S3 keys (e.g., "flexprice-exports/")                       |
-| `region`                                                                       | *string*                                                                       | :heavy_minus_sign:                                                             | AWS region (e.g., "us-west-2")                                                 |
-| `usePathStyle`                                                                 | *boolean*                                                                      | :heavy_minus_sign:                                                             | Use path-style addressing instead of virtual-hosted-style (required for MinIO) |
+| Field                                                                     | Type                                                                      | Required                                                                  | Description                                                               |
+| ------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `bucket`                                                                  | *string*                                                                  | :heavy_minus_sign:                                                        | S3 bucket name                                                            |
+| `compression`                                                             | [models.S3CompressionType](../../sdk/models/s3-compression-type.md)       | :heavy_minus_sign:                                                        | N/A                                                                       |
+| `encryption`                                                              | [models.S3EncryptionType](../../sdk/models/s3-encryption-type.md)         | :heavy_minus_sign:                                                        | N/A                                                                       |
+| `endpointUrl`                                                             | *string*                                                                  | :heavy_minus_sign:                                                        | Custom S3 endpoint URL (e.g., "http://minio:9000" for MinIO)              |
+| `exportMetadataFields`                                                    | [models.ExportMetadataField](../../sdk/models/export-metadata-field.md)[] | :heavy_minus_sign:                                                        | Optional user-selected metadata columns                                   |
+| `keyPrefix`                                                               | *string*                                                                  | :heavy_minus_sign:                                                        | Optional prefix for S3 keys (e.g., "flexprice-exports/")                  |
+| `region`                                                                  | *string*                                                                  | :heavy_minus_sign:                                                        | AWS region (e.g., "us-west-2")                                            |
+| `usePathStyle`                                                            | *boolean*                                                                 | :heavy_minus_sign:                                                        | Use path-style addressing (required for MinIO)                            |

package/docs/sdk/models/scheduled-task-entity-type.md

@@ -13,5 +13,5 @@ let value: ScheduledTaskEntityType = "invoice";
 ## Values
 
 ```typescript
-"events" | "invoice" | "credit_topups" | "credit_usage" | Unrecognized<string>
+"events" | "invoice" | "credit_topups" | "credit_usage" | "usage_analytics" | Unrecognized<string>
 ```

package/docs/sdk/models/sub-modify-grouped-invoicing-params.md

@@ -0,0 +1,19 @@
+# SubModifyGroupedInvoicingParams
+
+## Example Usage
+
+```typescript
+import { SubModifyGroupedInvoicingParams } from "@flexprice/sdk/sdk/models";
+
+let value: SubModifyGroupedInvoicingParams = {
+  action: "remove",
+};
+```
+
+## Fields
+
+| Field                                                                         | Type                                                                          | Required                                                                      | Description                                                                   |
+| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `action`                                                                      | [models.GroupedInvoicingAction](../../sdk/models/grouped-invoicing-action.md) | :heavy_check_mark:                                                            | N/A                                                                           |
+| `childSubscriptionIds`                                                        | *string*[]                                                                    | :heavy_minus_sign:                                                            | N/A                                                                           |
+| `parentSubscriptionId`                                                        | *string*                                                                      | :heavy_minus_sign:                                                            | ParentSubscriptionID is required for action 'add'.                            |

package/docs/sdk/models/subscription-inheritance-config.md

@@ -10,8 +10,9 @@ let value: SubscriptionInheritanceConfig = {};
 
 ## Fields
 
-| Field                                      | Type                                       | Required                                   | Description                                |
-| ------------------------------------------ | ------------------------------------------ | ------------------------------------------ | ------------------------------------------ |
-| `externalCustomerIdsToInheritSubscription` | *string*[]                                 | :heavy_minus_sign:                         | N/A                                        |
-| `invoicingCustomerExternalId`              | *string*                                   | :heavy_minus_sign:                         | N/A                                        |
-| `parentSubscriptionId`                     | *string*                                   | :heavy_minus_sign:                         | N/A                                        |
+| Field                                                                                                                                                                         | Type                                                                                                                                                                          | Required                                                                                                                                                                      | Description                                                                                                                                                                   |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `externalCustomerIdsToInheritSubscription`                                                                                                                                    | *string*[]                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                            | ExternalCustomerIDsToInheritSubscription: child customer external IDs for which<br/>inherited skeleton subscriptions will be created. Only valid for parent behavior.         |
+| `invoicingCustomerExternalId`                                                                                                                                                 | *string*                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                            | InvoicingCustomerExternalID sets a different billing recipient (external ID).<br/>Required for delegated; rejected for inherited; optional for others.                        |
+| `parentSubscriptionId`                                                                                                                                                        | *string*                                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                            | ParentSubscriptionID links this subscription to an existing parent.<br/>Required for inherited and grouped_invoicing; rejected for standalone, delegated, parent.             |
+| `subscriptionsIdsForGroupedInvoicing`                                                                                                                                         | *string*[]                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                            | SubscriptionsIDsForGroupedInvoicing: existing standalone subscription IDs to convert to<br/>grouped_invoicing under this parent at creation time. Only valid for parent behavior. |

package/docs/sdk/models/subscription-line-item-filter-order.md

@@ -0,0 +1,15 @@
+# SubscriptionLineItemFilterOrder
+
+## Example Usage
+
+```typescript
+import { SubscriptionLineItemFilterOrder } from "@flexprice/sdk/sdk/models";
+
+let value: SubscriptionLineItemFilterOrder = "asc";
+```
+
+## Values
+
+```typescript
+"asc" | "desc"
+```

package/docs/sdk/models/subscription-line-item-filter.md

@@ -0,0 +1,34 @@
+# SubscriptionLineItemFilter
+
+## Example Usage
+
+```typescript
+import { SubscriptionLineItemFilter } from "@flexprice/sdk/sdk/models";
+
+let value: SubscriptionLineItemFilter = {};
+```
+
+## Fields
+
+| Field                                                                                             | Type                                                                                              | Required                                                                                          | Description                                                                                       |
+| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `activeFilter`                                                                                    | *boolean*                                                                                         | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `addonAssociationIds`                                                                             | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `billingPeriods`                                                                                  | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `currencies`                                                                                      | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `currentPeriodStart`                                                                              | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)     | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `customerIds`                                                                                     | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `endTime`                                                                                         | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)     | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `entityIds`                                                                                       | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `entityType`                                                                                      | [models.SubscriptionLineItemEntityType](../../sdk/models/subscription-line-item-entity-type.md)   | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `expand`                                                                                          | *string*                                                                                          | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `filters`                                                                                         | [models.FilterCondition](../../sdk/models/filter-condition.md)[]                                  | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `limit`                                                                                           | *number*                                                                                          | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `meterIds`                                                                                        | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `offset`                                                                                          | *number*                                                                                          | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `order`                                                                                           | [models.SubscriptionLineItemFilterOrder](../../sdk/models/subscription-line-item-filter-order.md) | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `priceIds`                                                                                        | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `sort`                                                                                            | [models.SortCondition](../../sdk/models/sort-condition.md)[]                                      | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `startTime`                                                                                       | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)     | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `status`                                                                                          | [models.Status](../../sdk/models/status.md)                                                       | :heavy_minus_sign:                                                                                | N/A                                                                                               |
+| `subscriptionIds`                                                                                 | *string*[]                                                                                        | :heavy_minus_sign:                                                                                | Specific filters                                                                                  |

package/docs/sdk/models/subscription-modify-type.md

@@ -5,11 +5,11 @@
 ```typescript
 import { SubscriptionModifyType } from "@flexprice/sdk/sdk/models";
 
-let value: SubscriptionModifyType = "quantity_change";
+let value: SubscriptionModifyType = "grouped_invoicing";
 ```
 
 ## Values
 
 ```typescript
-"inheritance" | "quantity_change"
+"inheritance" | "quantity_change" | "grouped_invoicing"
 ```

package/docs/sdk/models/subscription-type.md

@@ -13,5 +13,5 @@ let value: SubscriptionType = "inherited";
 ## Values
 
 ```typescript
-"standalone" | "parent" | "inherited" | Unrecognized<string>
+"standalone" | "delegated_invoicing" | "parent" | "inherited" | "grouped_invoicing" | Unrecognized<string>
 ```

package/docs/sdk/models/window-size.md

@@ -5,7 +5,7 @@
 ```typescript
 import { WindowSize } from "@flexprice/sdk/sdk/models";
 
-let value: WindowSize = "12HOUR";
+let value: WindowSize = "6HOUR";
 
 // Open enum: unrecognized values are captured as Unrecognized<string>
 ```
@@ -13,5 +13,5 @@ let value: WindowSize = "12HOUR";
 ## Values
 
 ```typescript
-"MINUTE" | "15MIN" | "30MIN" | "HOUR" | "3HOUR" | "6HOUR" | "12HOUR" | "DAY" | "WEEK" | "MONTH" | Unrecognized<string>
+"MONTH" | "MINUTE" | "15MIN" | "30MIN" | "HOUR" | "3HOUR" | "6HOUR" | "12HOUR" | "DAY" | "WEEK" | Unrecognized<string>
 ```

package/docs/sdks/scheduledtasks/README.md

@@ -101,7 +101,7 @@ const flexprice = new Flexprice({
 async function run() {
   const result = await flexprice.scheduledTasks.createScheduledTask({
     connectionId: "<id>",
-    entityType: "credit_topups",
+    entityType: "credit_usage",
     interval: "custom",
     jobConfig: {},
   });
@@ -129,7 +129,7 @@ const flexprice = new FlexpriceCore({
 async function run() {
   const res = await scheduledTasksCreateScheduledTask(flexprice, {
     connectionId: "<id>",
-    entityType: "credit_topups",
+    entityType: "credit_usage",
     interval: "custom",
     jobConfig: {},
   });

package/docs/sdks/subscriptions/README.md

@@ -7,6 +7,7 @@
 * [createSubscription](#createsubscription) - Create subscription
 * [addSubscriptionAddon](#addsubscriptionaddon) - Add addon to subscription
 * [removeSubscriptionAddon](#removesubscriptionaddon) - Remove addon from subscription
+* [querySubscriptionLineItems](#querysubscriptionlineitems) - Search subscription line items
 * [updateSubscriptionLineItem](#updatesubscriptionlineitem) - Update subscription line item
 * [deleteSubscriptionLineItem](#deletesubscriptionlineitem) - Delete subscription line item
 * [querySubscription](#querysubscription) - Query subscriptions
@@ -260,6 +261,77 @@ run();
 | models.ErrorsErrorResponse | 500                        | application/json           |
 | models.SDKError            | 4XX, 5XX                   | \*/\*                      |
 
+## querySubscriptionLineItems
+
+List subscription line items with a JSON filter (subscription, customer, price, pagination, expand=prices, etc.).
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="querySubscriptionLineItems" method="post" path="/subscriptions/lineitems/search" -->
+```typescript
+import { Flexprice } from "@flexprice/sdk";
+
+const flexprice = new Flexprice({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await flexprice.subscriptions.querySubscriptionLineItems({});
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { FlexpriceCore } from "@flexprice/sdk/core.js";
+import { subscriptionsQuerySubscriptionLineItems } from "@flexprice/sdk/funcs/subscriptions-query-subscription-line-items.js";
+
+// Use `FlexpriceCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const flexprice = new FlexpriceCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await subscriptionsQuerySubscriptionLineItems(flexprice, {});
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("subscriptionsQuerySubscriptionLineItems failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [models.SubscriptionLineItemFilter](../../sdk/models/subscription-line-item-filter.md)                                                                                         | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[models.ListSubscriptionLineItemsResponse](../../sdk/models/list-subscription-line-items-response.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| models.ErrorsErrorResponse | 400                        | application/json           |
+| models.ErrorsErrorResponse | 500                        | application/json           |
+| models.SDKError            | 4XX, 5XX                   | \*/\*                      |
+
 ## updateSubscriptionLineItem
 
 Use when changing a subscription line item (e.g. quantity or price). Implemented by ending the current line and creating a new one for clean billing.
@@ -1397,7 +1469,7 @@ const flexprice = new Flexprice({
 
 async function run() {
   const result = await flexprice.subscriptions.previewSubscriptionModify("<id>", {
-    type: "quantity_change",
+    type: "grouped_invoicing",
   });
 
   console.log(result);
@@ -1422,7 +1494,7 @@ const flexprice = new FlexpriceCore({
 
 async function run() {
   const res = await subscriptionsPreviewSubscriptionModify(flexprice, "<id>", {
-    type: "quantity_change",
+    type: "grouped_invoicing",
   });
   if (res.ok) {
     const { value: result } = res;

package/esm/funcs/subscriptions-query-subscription-line-items.d.ts

@@ -0,0 +1,17 @@
+import { FlexpriceCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { FlexPriceError } from "../sdk/models/flex-price-error.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../sdk/models/http-client-errors.js";
+import * as models from "../sdk/models/index.js";
+import { ResponseValidationError } from "../sdk/models/response-validation-error.js";
+import { SDKValidationError } from "../sdk/models/sdk-validation-error.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * Search subscription line items
+ *
+ * @remarks
+ * List subscription line items with a JSON filter (subscription, customer, price, pagination, expand=prices, etc.).
+ */
+export declare function subscriptionsQuerySubscriptionLineItems(client: FlexpriceCore, request: models.SubscriptionLineItemFilter, options?: RequestOptions): APIPromise<Result<models.ListSubscriptionLineItemsResponse, models.ErrorsErrorResponse | FlexPriceError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=subscriptions-query-subscription-line-items.d.ts.map

package/esm/funcs/subscriptions-query-subscription-line-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions-query-subscription-line-items.d.ts","sourceRoot":"","sources":["../../src/funcs/subscriptions-query-subscription-line-items.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,CAAC,0BAA0B,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,MAAM,CAAC,iCAAiC,EACtC,MAAM,CAAC,mBAAmB,GAC1B,cAAc,GACd,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}

package/esm/funcs/subscriptions-query-subscription-line-items.js

@@ -0,0 +1,83 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { encodeJSON } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as models from "../sdk/models/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * Search subscription line items
+ *
+ * @remarks
+ * List subscription line items with a JSON filter (subscription, customer, price, pagination, expand=prices, etc.).
+ */
+export function subscriptionsQuerySubscriptionLineItems(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => z.parse(models.SubscriptionLineItemFilter$outboundSchema, value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = encodeJSON("body", payload, { explode: true });
+    const path = pathToFunc("/subscriptions/lineitems/search")();
+    const headers = new Headers(compactMap({
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    }));
+    const secConfig = await extractSecurity(client._options.apiKeyAuth);
+    const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "querySubscriptionLineItems",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKeyAuth,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "POST",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        isErrorStatusCode: (statusCode) => matchStatusCode({ status: statusCode }, ["4XX", "5XX"]),
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.json(200, models.ListSubscriptionLineItemsResponse$inboundSchema), M.jsonErr(400, models.ErrorsErrorResponse$inboundSchema), M.jsonErr(500, models.ErrorsErrorResponse$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=subscriptions-query-subscription-line-items.js.map