feat: invoice delete v3 endpoints

Author: borosr

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

@@ -194,11 +194,16 @@ 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.                                                                                                                                                                                                                                           |
+| `client.invoices.advance`            | `POST /openmeter/billing/invoices/{invoiceId}/advance`             | Advance a billing invoice. Advances the invoice to the next workflow state. The next state is determined by the invoice's current status and workflow configuration. Only invoices in draft or issued status can be advanced.                                                                                                                                                                                         |
+| `client.invoices.approve`            | `POST /openmeter/billing/invoices/{invoiceId}/approve`             | Approve a billing invoice. This call instantly sends the invoice to the customer using the configured billing profile app. This call is valid in two invoice statuses: - draft: the invoice will be sent to the customer, the invoice state becomes issued - manual_approval_needed: the invoice will be sent to the customer, the invoice state becomes issued                                                       |
+| `client.invoices.retry`              | `POST /openmeter/billing/invoices/{invoiceId}/retry`               | Retry sending a billing invoice. Retry advancing the invoice after a failed attempt. The action can be called when the invoice's statusDetails' actions field contain the "retry" action.                                                                                                                                                                                                                             |
+| `client.invoices.snapshotQuantities` | `POST /openmeter/billing/invoices/{invoiceId}/snapshot-quantities` | Snapshot quantities for usage-based line items. This call will snapshot the quantities for all usage based line items in the invoice. This call is only valid in draft.waiting_for_collection status, where the collection period can be skipped using this action.                                                                                                                                                   |
 
 ### Tax
 

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

@@ -11,6 +11,16 @@ import type {
   GetInvoiceResponse,
   UpdateInvoiceRequest,
   UpdateInvoiceResponse,
+  DeleteInvoiceRequest,
+  DeleteInvoiceResponse,
+  AdvanceInvoiceRequest,
+  AdvanceInvoiceResponse,
+  ApproveInvoiceRequest,
+  ApproveInvoiceResponse,
+  RetryInvoiceRequest,
+  RetryInvoiceResponse,
+  SnapshotQuantitiesInvoiceRequest,
+  SnapshotQuantitiesInvoiceResponse,
 } from '../models/operations/invoices.js'
 
 export function listInvoices(
@@ -94,3 +104,115 @@ 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)
+  })
+}
+
+export function advanceInvoice(
+  client: Client,
+  req: AdvanceInvoiceRequest,
+  options?: RequestOptions,
+): Promise<Result<AdvanceInvoiceResponse>> {
+  return request(() => {
+    const path = `openmeter/billing/invoices/${(() => {
+      if (req.invoiceId === undefined) {
+        throw new Error('missing path parameter: invoiceId')
+      }
+      return encodeURIComponent(String(req.invoiceId))
+    })()}/advance`
+    return http(client)
+      .post(path, options)
+      .json()
+      .then((data) => {
+        if (client._options.validate) {
+          assertValid(schemas.advanceInvoiceResponseWire, data)
+        }
+        return fromWire(data, schemas.advanceInvoiceResponse)
+      })
+  })
+}
+
+export function approveInvoice(
+  client: Client,
+  req: ApproveInvoiceRequest,
+  options?: RequestOptions,
+): Promise<Result<ApproveInvoiceResponse>> {
+  return request(() => {
+    const path = `openmeter/billing/invoices/${(() => {
+      if (req.invoiceId === undefined) {
+        throw new Error('missing path parameter: invoiceId')
+      }
+      return encodeURIComponent(String(req.invoiceId))
+    })()}/approve`
+    return http(client)
+      .post(path, options)
+      .json()
+      .then((data) => {
+        if (client._options.validate) {
+          assertValid(schemas.approveInvoiceResponseWire, data)
+        }
+        return fromWire(data, schemas.approveInvoiceResponse)
+      })
+  })
+}
+
+export function retryInvoice(
+  client: Client,
+  req: RetryInvoiceRequest,
+  options?: RequestOptions,
+): Promise<Result<RetryInvoiceResponse>> {
+  return request(() => {
+    const path = `openmeter/billing/invoices/${(() => {
+      if (req.invoiceId === undefined) {
+        throw new Error('missing path parameter: invoiceId')
+      }
+      return encodeURIComponent(String(req.invoiceId))
+    })()}/retry`
+    return http(client)
+      .post(path, options)
+      .json()
+      .then((data) => {
+        if (client._options.validate) {
+          assertValid(schemas.retryInvoiceResponseWire, data)
+        }
+        return fromWire(data, schemas.retryInvoiceResponse)
+      })
+  })
+}
+
+export function snapshotQuantitiesInvoice(
+  client: Client,
+  req: SnapshotQuantitiesInvoiceRequest,
+  options?: RequestOptions,
+): Promise<Result<SnapshotQuantitiesInvoiceResponse>> {
+  return request(() => {
+    const path = `openmeter/billing/invoices/${(() => {
+      if (req.invoiceId === undefined) {
+        throw new Error('missing path parameter: invoiceId')
+      }
+      return encodeURIComponent(String(req.invoiceId))
+    })()}/snapshot-quantities`
+    return http(client)
+      .post(path, options)
+      .json()
+      .then((data) => {
+        if (client._options.validate) {
+          assertValid(schemas.snapshotQuantitiesInvoiceResponseWire, data)
+        }
+        return fromWire(data, schemas.snapshotQuantitiesInvoiceResponse)
+      })
+  })
+}

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

@@ -48,3 +48,34 @@ export type UpdateInvoiceRequest = {
 export type UpdateInvoiceResponse = z.output<
   typeof schemas.updateInvoiceResponse
 >
+
+export type DeleteInvoiceRequest = {
+  invoiceId: string
+}
+export type DeleteInvoiceResponse = void
+
+export type AdvanceInvoiceRequest = {
+  invoiceId: string
+}
+export type AdvanceInvoiceResponse = z.output<
+  typeof schemas.advanceInvoiceResponse
+>
+
+export type ApproveInvoiceRequest = {
+  invoiceId: string
+}
+export type ApproveInvoiceResponse = z.output<
+  typeof schemas.approveInvoiceResponse
+>
+
+export type RetryInvoiceRequest = {
+  invoiceId: string
+}
+export type RetryInvoiceResponse = z.output<typeof schemas.retryInvoiceResponse>
+
+export type SnapshotQuantitiesInvoiceRequest = {
+  invoiceId: string
+}
+export type SnapshotQuantitiesInvoiceResponse = z.output<
+  typeof schemas.snapshotQuantitiesInvoiceResponse
+>

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

@@ -6120,6 +6120,34 @@ export const updateInvoiceBody = updateInvoiceRequest
 
 export const updateInvoiceResponse = invoice
 
+export const deleteInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
+export const advanceInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
+export const advanceInvoiceResponse = invoice
+
+export const approveInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
+export const approveInvoiceResponse = invoice
+
+export const retryInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
+export const retryInvoiceResponse = invoice
+
+export const snapshotQuantitiesInvoicePathParams = z.object({
+  invoiceId: ulid,
+})
+
+export const snapshotQuantitiesInvoiceResponse = invoice
+
 export const createTaxCodeBody = createTaxCodeRequest
 
 export const createTaxCodeResponse = taxCode
@@ -12654,6 +12682,34 @@ export const updateInvoiceBodyWire = updateInvoiceRequestWire
 
 export const updateInvoiceResponseWire = invoiceWire
 
+export const deleteInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
+export const advanceInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
+export const advanceInvoiceResponseWire = invoiceWire
+
+export const approveInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
+export const approveInvoiceResponseWire = invoiceWire
+
+export const retryInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
+export const retryInvoiceResponseWire = invoiceWire
+
+export const snapshotQuantitiesInvoicePathParamsWire = z.object({
+  invoiceId: ulidWire,
+})
+
+export const snapshotQuantitiesInvoiceResponseWire = invoiceWire
+
 export const createTaxCodeBodyWire = createTaxCodeRequestWire
 
 export const createTaxCodeResponseWire = taxCodeWire

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

@@ -1,13 +1,32 @@
 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,
+  advanceInvoice,
+  approveInvoice,
+  retryInvoice,
+  snapshotQuantitiesInvoice,
+} from '../funcs/invoices.js'
 import type {
   ListInvoicesRequest,
   ListInvoicesResponse,
   GetInvoiceRequest,
   GetInvoiceResponse,
   UpdateInvoiceRequest,
   UpdateInvoiceResponse,
+  DeleteInvoiceRequest,
+  DeleteInvoiceResponse,
+  AdvanceInvoiceRequest,
+  AdvanceInvoiceResponse,
+  ApproveInvoiceRequest,
+  ApproveInvoiceResponse,
+  RetryInvoiceRequest,
+  RetryInvoiceResponse,
+  SnapshotQuantitiesInvoiceRequest,
+  SnapshotQuantitiesInvoiceResponse,
 } from '../models/operations/invoices.js'
 
 export class Invoices {
@@ -33,4 +52,41 @@ 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))
+  }
+
+  async advance(
+    request: AdvanceInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<AdvanceInvoiceResponse> {
+    return unwrap(await advanceInvoice(this._client, request, options))
+  }
+
+  async approve(
+    request: ApproveInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<ApproveInvoiceResponse> {
+    return unwrap(await approveInvoice(this._client, request, options))
+  }
+
+  async retry(
+    request: RetryInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<RetryInvoiceResponse> {
+    return unwrap(await retryInvoice(this._client, request, options))
+  }
+
+  async snapshotQuantities(
+    request: SnapshotQuantitiesInvoiceRequest,
+    options?: RequestOptions,
+  ): Promise<SnapshotQuantitiesInvoiceResponse> {
+    return unwrap(
+      await snapshotQuantitiesInvoice(this._client, request, options),
+    )
+  }
 }