feat: invoice delete v3 endpoint

api/spec/packages/aip-client-javascript/README.md

@@ -194,11 +194,12 @@ The full call path, HTTP route, and a short description are listed below.
 
 ### Invoices
 
-| Method                   | HTTP                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                           |
-| ------------------------ | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client.invoices.list`   | `GET /openmeter/billing/invoices`             | List billing invoices. Returns a page of invoices. Gathering invoices are never included. Use `filter` to narrow by status, customer, dates, or service period start. Use `sort` to control ordering.                                                                                                                                                                                                                 |
-| `client.invoices.get`    | `GET /openmeter/billing/invoices/{invoiceId}` | Get a billing invoice by ID. Returns the full invoice resource including line items, status details, totals, and workflow configuration snapshot.                                                                                                                                                                                                                                                                     |
-| `client.invoices.update` | `PUT /openmeter/billing/invoices/{invoiceId}` | Update a billing invoice. Only the mutable fields of the invoice can be edited: description, labels, supplier, customer, workflow settings, and top-level lines. Top-level lines are matched by `id`; lines without an `id` are created, and existing lines omitted from `lines` are deleted. Detailed (child) lines are always computed and cannot be edited directly. Only invoices in draft status can be updated. |
+| Method                   | HTTP                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ------------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `client.invoices.list`   | `GET /openmeter/billing/invoices`                | List billing invoices. Returns a page of invoices. Gathering invoices are never included. Use `filter` to narrow by status, customer, dates, or service period start. Use `sort` to control ordering.                                                                                                                                                                                                                 |
+| `client.invoices.get`    | `GET /openmeter/billing/invoices/{invoiceId}`    | Get a billing invoice by ID. Returns the full invoice resource including line items, status details, totals, and workflow configuration snapshot.                                                                                                                                                                                                                                                                     |
+| `client.invoices.update` | `PUT /openmeter/billing/invoices/{invoiceId}`    | Update a billing invoice. Only the mutable fields of the invoice can be edited: description, labels, supplier, customer, workflow settings, and top-level lines. Top-level lines are matched by `id`; lines without an `id` are created, and existing lines omitted from `lines` are deleted. Detailed (child) lines are always computed and cannot be edited directly. Only invoices in draft status can be updated. |
+| `client.invoices.delete` | `DELETE /openmeter/billing/invoices/{invoiceId}` | Delete a billing invoice. Only standard invoices in draft status can be deleted. Deleting an invoice will also delete all associated line items and workflow configuration.                                                                                                                                                                                                                                           |
 
 ### Tax
 

api/spec/packages/aip-client-javascript/src/funcs/invoices.ts

@@ -11,6 +11,8 @@ import type {
   GetInvoiceResponse,
   UpdateInvoiceRequest,
   UpdateInvoiceResponse,
+  DeleteInvoiceRequest,
+  DeleteInvoiceResponse,
 } from '../models/operations/invoices.js'
 
 export function listInvoices(
@@ -94,3 +96,19 @@ export function updateInvoice(
       })
   })
 }
+
+export function deleteInvoice(
+  client: Client,
+  req: DeleteInvoiceRequest,
+  options?: RequestOptions,
+): Promise<Result<DeleteInvoiceResponse>> {
+  return request(async () => {
+    const path = `openmeter/billing/invoices/${(() => {
+      if (req.invoiceId === undefined) {
+        throw new Error('missing path parameter: invoiceId')
+      }
+      return encodeURIComponent(String(req.invoiceId))
+    })()}`
+    await http(client).delete(path, options)
+  })
+}

api/spec/packages/aip-client-javascript/src/models/operations/invoices.ts

@@ -48,3 +48,8 @@ export type UpdateInvoiceRequest = {
 export type UpdateInvoiceResponse = z.output<
   typeof schemas.updateInvoiceResponse
 >
+
+export type DeleteInvoiceRequest = {
+  invoiceId: string
+}
+export type DeleteInvoiceResponse = void

api/spec/packages/aip-client-javascript/src/models/schemas.ts

@@ -6120,6 +6120,10 @@ export const updateInvoiceBody = updateInvoiceRequest
 
 export const updateInvoiceResponse = invoice
 
+export const deleteInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
 export const createTaxCodeBody = createTaxCodeRequest
 
 export const createTaxCodeResponse = taxCode
@@ -12654,6 +12658,10 @@ export const updateInvoiceBodyWire = updateInvoiceRequestWire
 
 export const updateInvoiceResponseWire = invoiceWire
 
+export const deleteInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
 export const createTaxCodeBodyWire = createTaxCodeRequestWire
 
 export const createTaxCodeResponseWire = taxCodeWire

api/spec/packages/aip-client-javascript/src/sdk/invoices.ts

@@ -1,13 +1,20 @@
 import { type Client } from '../core.js'
 import { unwrap, type RequestOptions } from '../lib/types.js'
-import { listInvoices, getInvoice, updateInvoice } from '../funcs/invoices.js'
+import {
+  listInvoices,
+  getInvoice,
+  updateInvoice,
+  deleteInvoice,
+} from '../funcs/invoices.js'
 import type {
   ListInvoicesRequest,
   ListInvoicesResponse,
   GetInvoiceRequest,
   GetInvoiceResponse,
   UpdateInvoiceRequest,
   UpdateInvoiceResponse,
+  DeleteInvoiceRequest,
+  DeleteInvoiceResponse,
 } from '../models/operations/invoices.js'
 
 export class Invoices {
@@ -33,4 +40,11 @@ export class Invoices {
   ): Promise<UpdateInvoiceResponse> {
     return unwrap(await updateInvoice(this._client, request, options))
   }
+
+  async delete(
+    request: DeleteInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<DeleteInvoiceResponse> {
+    return unwrap(await deleteInvoice(this._client, request, options))
+  }
 }

api/spec/packages/aip/src/invoices/operations.tsp

@@ -134,4 +134,21 @@ interface InvoicesOperations {
     @body
     invoice: UpdateInvoiceRequest,
   ): Shared.UpdateResponse<Invoice> | Common.NotFound | Common.ErrorResponses;
+
+  /**
+   * Delete a billing invoice.
+   *
+   * Only standard invoices in draft status can be deleted. Deleting an invoice will
+   * also delete all associated line items and workflow configuration.
+   */
+  @delete
+  @operationId("delete-invoice")
+  @summary("Delete a billing invoice")
+  @extension(Shared.UnstableExtension, true)
+  @extension(Shared.InternalExtension, true)
+  @extension(Shared.PrivateExtension, true)
+  delete(@path invoiceId: Shared.ULID):
+    | Shared.DeleteResponse
+    | Common.NotFound
+    | Common.ErrorResponses;
 }