feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-b070c1d97a6e3b400f43d2bce36c22ed89d432345b26374728c55dd0a20f0afa.yml
-openapi_spec_hash: dba4ff52c381cda6159fc56d8b77eb32
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-15e42bc01739abea4a925894a1a7de447de40b003a3433461952e8e06919588b.yml
+openapi_spec_hash: 8a0bc5b6ab417f7256cbf83d70c459a3
 config_hash: 1f73a949b649ecfe6ec68ba1bb459dc2

orb-java-core/src/main/kotlin/com/withorb/api/models/InvoiceLineItemCreateParams.kt

@@ -27,6 +27,15 @@ interface InvoiceLineItemServiceAsync {
     /**
      * This creates a one-off fixed fee invoice line item on an Invoice. This can only be done for
      * invoices that are in a `draft` status.
+     *
+     * The behavior depends on which parameters are provided:
+     * - If `item_id` is provided without `name`: The item is looked up by ID, and the item's name
+     *   is used for the line item.
+     * - If `name` is provided without `item_id`: An item with the given name is searched for in the
+     *   account. If found, that item is used. If not found, a new item is created with that name.
+     *   The new item's name is used for the line item.
+     * - If both `item_id` and `name` are provided: The item is looked up by ID for association, but
+     *   the provided `name` is used for the line item (not the item's name).
      */
     fun create(
         params: InvoiceLineItemCreateParams

orb-java-core/src/main/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsync.kt

@@ -27,6 +27,15 @@ interface InvoiceLineItemService {
     /**
      * This creates a one-off fixed fee invoice line item on an Invoice. This can only be done for
      * invoices that are in a `draft` status.
+     *
+     * The behavior depends on which parameters are provided:
+     * - If `item_id` is provided without `name`: The item is looked up by ID, and the item's name
+     *   is used for the line item.
+     * - If `name` is provided without `item_id`: An item with the given name is searched for in the
+     *   account. If found, that item is used. If not found, a new item is created with that name.
+     *   The new item's name is used for the line item.
+     * - If both `item_id` and `name` are provided: The item is looked up by ID for association, but
+     *   the provided `name` is used for the line item (not the item's name).
      */
     fun create(params: InvoiceLineItemCreateParams): InvoiceLineItemCreateResponse =
         create(params, RequestOptions.none())

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/InvoiceLineItemService.kt

@@ -14,9 +14,10 @@ internal class InvoiceLineItemCreateParamsTest {
             .amount("12.00")
             .endDate(LocalDate.parse("2023-09-22"))
             .invoiceId("4khy3nwzktxv7")
-            .name("Item Name")
             .quantity(1.0)
             .startDate(LocalDate.parse("2023-09-22"))
+            .itemId("4khy3nwzktxv7")
+            .name("Item Name")
             .build()
     }
 
@@ -27,7 +28,30 @@ internal class InvoiceLineItemCreateParamsTest {
                 .amount("12.00")
                 .endDate(LocalDate.parse("2023-09-22"))
                 .invoiceId("4khy3nwzktxv7")
+                .quantity(1.0)
+                .startDate(LocalDate.parse("2023-09-22"))
+                .itemId("4khy3nwzktxv7")
                 .name("Item Name")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.amount()).isEqualTo("12.00")
+        assertThat(body.endDate()).isEqualTo(LocalDate.parse("2023-09-22"))
+        assertThat(body.invoiceId()).isEqualTo("4khy3nwzktxv7")
+        assertThat(body.quantity()).isEqualTo(1.0)
+        assertThat(body.startDate()).isEqualTo(LocalDate.parse("2023-09-22"))
+        assertThat(body.itemId()).contains("4khy3nwzktxv7")
+        assertThat(body.name()).contains("Item Name")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params =
+            InvoiceLineItemCreateParams.builder()
+                .amount("12.00")
+                .endDate(LocalDate.parse("2023-09-22"))
+                .invoiceId("4khy3nwzktxv7")
                 .quantity(1.0)
                 .startDate(LocalDate.parse("2023-09-22"))
                 .build()
@@ -37,7 +61,6 @@ internal class InvoiceLineItemCreateParamsTest {
         assertThat(body.amount()).isEqualTo("12.00")
         assertThat(body.endDate()).isEqualTo(LocalDate.parse("2023-09-22"))
         assertThat(body.invoiceId()).isEqualTo("4khy3nwzktxv7")
-        assertThat(body.name()).isEqualTo("Item Name")
         assertThat(body.quantity()).isEqualTo(1.0)
         assertThat(body.startDate()).isEqualTo(LocalDate.parse("2023-09-22"))
     }

orb-java-core/src/test/kotlin/com/withorb/api/models/InvoiceLineItemCreateParamsTest.kt

@@ -27,9 +27,10 @@ internal class InvoiceLineItemServiceAsyncTest {
                     .amount("12.00")
                     .endDate(LocalDate.parse("2023-09-22"))
                     .invoiceId("4khy3nwzktxv7")
-                    .name("Item Name")
                     .quantity(1.0)
                     .startDate(LocalDate.parse("2023-09-22"))
+                    .itemId("4khy3nwzktxv7")
+                    .name("Item Name")
                     .build()
             )
 

orb-java-core/src/test/kotlin/com/withorb/api/services/async/InvoiceLineItemServiceAsyncTest.kt

@@ -27,9 +27,10 @@ internal class InvoiceLineItemServiceTest {
                     .amount("12.00")
                     .endDate(LocalDate.parse("2023-09-22"))
                     .invoiceId("4khy3nwzktxv7")
-                    .name("Item Name")
                     .quantity(1.0)
                     .startDate(LocalDate.parse("2023-09-22"))
+                    .itemId("4khy3nwzktxv7")
+                    .name("Item Name")
                     .build()
             )