@openmeter/client 1.0.0-beta-1d51ec73a3d5 → 1.0.0-beta-05de7df7a13f

package/dist/models/schemas.js

@@ -4550,6 +4550,37 @@ export const updateBillingProfileResponse = profile;
 export const deleteBillingProfilePathParams = z.object({
     id: ulid,
 });
+export const listInvoicesQueryParams = z.object({
+    page: z
+        .object({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: sortQuery.optional(),
+    filter: listInvoicesParamsFilter.optional(),
+});
+export const listInvoicesResponse = z.object({
+    data: z.array(invoice),
+    meta: paginatedMeta,
+});
+export const getInvoicePathParams = z.object({
+    invoiceId: ulid,
+});
+export const getInvoiceResponse = invoice;
+export const updateInvoicePathParams = z.object({
+    invoiceId: ulid,
+});
+export const updateInvoiceBody = updateInvoiceRequest;
+export const updateInvoiceResponse = invoice;
+export const deleteInvoicePathParams = z.object({
+    invoiceId: ulid,
+});
 export const createTaxCodeBody = createTaxCodeRequest;
 export const createTaxCodeResponse = taxCode;
 export const getTaxCodePathParams = z.object({
@@ -4841,6 +4872,11 @@ export const deletePlanAddonPathParams = z.object({
 export const getOrganizationDefaultTaxCodesResponse = organizationDefaultTaxCodes;
 export const updateOrganizationDefaultTaxCodesBody = updateOrganizationDefaultTaxCodesRequest;
 export const updateOrganizationDefaultTaxCodesResponse = organizationDefaultTaxCodes;
+export const queryGovernanceAccessQueryParams = z.object({
+    page: cursorPaginationQueryPage.optional(),
+});
+export const queryGovernanceAccessBody = governanceQueryRequest;
+export const queryGovernanceAccessResponse = governanceQueryResponse;
 export const labelsWire = z
     .record(z.string(), z.string())
     .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
@@ -9410,6 +9446,37 @@ export const updateBillingProfileResponseWire = profileWire;
 export const deleteBillingProfilePathParamsWire = z.object({
     id: ulidWire,
 });
+export const listInvoicesQueryParamsWire = z.object({
+    page: z
+        .strictObject({
+        size: z.coerce
+            .number()
+            .int()
+            .optional()
+            .describe('The number of items to include per page.'),
+        number: z.coerce.number().int().optional().describe('The page number.'),
+    })
+        .optional()
+        .describe('Determines which page of the collection to retrieve.'),
+    sort: sortQueryWire.optional(),
+    filter: listInvoicesParamsFilterWire.optional(),
+});
+export const listInvoicesResponseWire = z.strictObject({
+    data: z.array(invoiceWire),
+    meta: paginatedMetaWire,
+});
+export const getInvoicePathParamsWire = z.object({
+    invoiceId: ulidWire,
+});
+export const getInvoiceResponseWire = invoiceWire;
+export const updateInvoicePathParamsWire = z.object({
+    invoiceId: ulidWire,
+});
+export const updateInvoiceBodyWire = updateInvoiceRequestWire;
+export const updateInvoiceResponseWire = invoiceWire;
+export const deleteInvoicePathParamsWire = z.object({
+    invoiceId: ulidWire,
+});
 export const createTaxCodeBodyWire = createTaxCodeRequestWire;
 export const createTaxCodeResponseWire = taxCodeWire;
 export const getTaxCodePathParamsWire = z.object({
@@ -9701,3 +9768,8 @@ export const deletePlanAddonPathParamsWire = z.object({
 export const getOrganizationDefaultTaxCodesResponseWire = organizationDefaultTaxCodesWire;
 export const updateOrganizationDefaultTaxCodesBodyWire = updateOrganizationDefaultTaxCodesRequestWire;
 export const updateOrganizationDefaultTaxCodesResponseWire = organizationDefaultTaxCodesWire;
+export const queryGovernanceAccessQueryParamsWire = z.object({
+    page: cursorPaginationQueryPageWire.optional(),
+});
+export const queryGovernanceAccessBodyWire = governanceQueryRequestWire;
+export const queryGovernanceAccessResponseWire = governanceQueryResponseWire;

package/dist/models/types.d.ts

@@ -3109,7 +3109,7 @@ export interface UpdateBillingInvoiceWorkflow {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettings;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
+    payment?: UpdateBillingWorkflowPaymentSettings;
 }
 /** Access status for a single feature. */
 export interface GovernanceFeatureAccess {
@@ -4138,7 +4138,7 @@ export interface InvoiceLineRateCard {
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface UpdateInvoiceLineRateCard {
     /** The price definition used to calculate charges for this line. */
-    price: UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
+    price: UpdatePrice;
     /** Tax configuration snapshot for this line. */
     taxConfig?: UpdateRateCardTaxConfig;
     /** The feature key associated with this line's rate card. */
@@ -4861,7 +4861,7 @@ export interface InvoiceStandard {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLine[];
+    lines?: InvoiceLine[];
 }
 /** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequest {
@@ -4892,11 +4892,11 @@ export interface UpdateInvoiceStandardRequest {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponse {
-    data: InvoiceStandard[];
+    data: Invoice[];
     meta: PaginatedMeta;
 }
 /**
@@ -4965,6 +4965,8 @@ export type DateTimeFieldFilter = Date | {
 export type SubscriptionEditTiming = 'immediate' | 'next_billing_cycle' | Date;
 /** Payment settings for a billing workflow. */
 export type WorkflowPaymentSettings = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettings = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
 /** A parameter that failed validation. */
 export type InvalidParameter = InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem;
 /**
@@ -4991,10 +4993,38 @@ export type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscriptio
 export type App = AppStripe | AppSandbox | AppExternalInvoicing;
 /** Price. */
 export type Price = PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+/** Price. */
+export type UpdatePrice = UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
 /** Customer charge. */
 export type CreateChargeRequest = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequest;
 /** Customer charge. */
 export type Charge = ChargeFlatFee | ChargeUsageBased;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLine = InvoiceStandardLine;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type UpdateInvoiceLine = UpdateInvoiceStandardLine;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type Invoice = InvoiceStandard;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequest = UpdateInvoiceStandardRequest;
 /**
  * Sort query.
  *
@@ -5405,7 +5435,7 @@ export interface UpdateBillingInvoiceWorkflowInput {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettingsInput;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
+    payment?: UpdateBillingWorkflowPaymentSettingsInput;
 }
 /** CreditGrant create request. */
 export interface CreateCreditGrantRequestInput {
@@ -6438,7 +6468,7 @@ export interface InvoiceStandardInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLineInput[];
+    lines?: InvoiceLineInput[];
 }
 /** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequestInput {
@@ -6469,17 +6499,37 @@ export interface UpdateInvoiceStandardRequestInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponseInput {
-    data: InvoiceStandardInput[];
+    data: InvoiceInput[];
     meta: PaginatedMeta;
 }
 /** Payment settings for a billing workflow. */
 export type WorkflowPaymentSettingsInput = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettingsInput = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
 /**
  * Entitlement template configured on a rate card. The feature is taken from the
  * rate card itself, so it is omitted here.
  */
 export type RateCardEntitlementInput = RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLineInput = InvoiceStandardLineInput;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type InvoiceInput = InvoiceStandardInput;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequestInput = UpdateInvoiceStandardRequestInput;

package/dist/sdk/internal.d.ts

@@ -1,8 +1,10 @@
 import { type Client } from '../core.js';
 import { type RequestOptions } from '../lib/types.js';
 import type { CreateSubscriptionAddonRequest, CreateSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
+import type { ListInvoicesRequest, ListInvoicesResponse, GetInvoiceRequest, GetInvoiceResponse, UpdateInvoiceRequest, UpdateInvoiceResponse, DeleteInvoiceRequest, DeleteInvoiceResponse } from '../models/operations/invoices.js';
 import type { ListCurrenciesRequest, ListCurrenciesResponse, CreateCustomCurrencyRequest, CreateCustomCurrencyResponse, ListCostBasesRequest, ListCostBasesResponse, CreateCostBasisRequest, CreateCostBasisResponse } from '../models/operations/currencies.js';
-import type { CostBasis, Currency } from '../models/types.js';
+import type { QueryGovernanceAccessRequest, QueryGovernanceAccessResponse } from '../models/operations/governance.js';
+import type { CostBasis, Currency, Invoice } from '../models/types.js';
 /**
  * Operations marked internal in the API definition. They are not part of
  * the customer surface: they may require additional permissions, and they
@@ -13,8 +15,12 @@ export declare class Internal {
     constructor(_client: Client);
     private _subscriptions?;
     get subscriptions(): InternalSubscriptions;
+    private _invoices?;
+    get invoices(): InternalInvoices;
     private _currencies?;
     get currencies(): InternalCurrencies;
+    private _governance?;
+    get governance(): InternalGovernance;
 }
 export declare class InternalSubscriptions {
     private readonly _client;
@@ -28,6 +34,72 @@ export declare class InternalSubscriptions {
      */
     createAddon(request: CreateSubscriptionAddonRequest, options?: RequestOptions): Promise<CreateSubscriptionAddonResponse>;
 }
+export declare class InternalInvoices {
+    private readonly _client;
+    constructor(_client: Client);
+    /**
+     * List 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.
+     *
+     * GET /openmeter/billing/invoices
+     */
+    list(request?: ListInvoicesRequest, options?: RequestOptions): Promise<ListInvoicesResponse>;
+    /**
+     * List 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.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/billing/invoices
+     */
+    listAll(request?: ListInvoicesRequest, options?: RequestOptions): AsyncIterable<Invoice>;
+    /**
+     * Get a billing invoice
+     *
+     * Get a billing invoice by ID.
+     *
+     * Returns the full invoice resource including line items, status details, totals,
+     * and workflow configuration snapshot.
+     *
+     * GET /openmeter/billing/invoices/{invoiceId}
+     */
+    get(request: GetInvoiceRequest, options?: RequestOptions): Promise<GetInvoiceResponse>;
+    /**
+     * Update a billing invoice
+     *
+     * 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.
+     *
+     * PUT /openmeter/billing/invoices/{invoiceId}
+     */
+    update(request: UpdateInvoiceRequest, options?: RequestOptions): Promise<UpdateInvoiceResponse>;
+    /**
+     * Delete a billing invoice
+     *
+     * 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 /openmeter/billing/invoices/{invoiceId}
+     */
+    delete(request: DeleteInvoiceRequest, options?: RequestOptions): Promise<DeleteInvoiceResponse>;
+}
 export declare class InternalCurrencies {
     private readonly _client;
     constructor(_client: Client);
@@ -87,3 +159,22 @@ export declare class InternalCurrencies {
      */
     createCostBasis(request: CreateCostBasisRequest, options?: RequestOptions): Promise<CreateCostBasisResponse>;
 }
+export declare class InternalGovernance {
+    private readonly _client;
+    constructor(_client: Client);
+    /**
+     * Query governance access
+     *
+     * Query feature access for a list of customers.
+     *
+     * The endpoint resolves each provided identifier to a customer and returns the
+     * access status for the requested features, plus optional credit balance
+     * availability.
+     *
+     * _Designed to be called on a fixed refresh interval and the query response is
+     * intended to be cached._
+     *
+     * POST /openmeter/governance/query
+     */
+    queryAccess(request: QueryGovernanceAccessRequest, options?: RequestOptions): Promise<QueryGovernanceAccessResponse>;
+}

package/dist/sdk/internal.js

@@ -2,7 +2,9 @@
 import { unwrap } from '../lib/types.js';
 import { paginatePages } from '../lib/paginate.js';
 import { createSubscriptionAddon } from '../funcs/subscriptions.js';
+import { listInvoices, getInvoice, updateInvoice, deleteInvoice, } from '../funcs/invoices.js';
 import { listCurrencies, createCustomCurrency, listCostBases, createCostBasis, } from '../funcs/currencies.js';
+import { queryGovernanceAccess } from '../funcs/governance.js';
 /**
  * Operations marked internal in the API definition. They are not part of
  * the customer surface: they may require additional permissions, and they
@@ -17,10 +19,18 @@ export class Internal {
     get subscriptions() {
         return (this._subscriptions ??= new InternalSubscriptions(this._client));
     }
+    _invoices;
+    get invoices() {
+        return (this._invoices ??= new InternalInvoices(this._client));
+    }
     _currencies;
     get currencies() {
         return (this._currencies ??= new InternalCurrencies(this._client));
     }
+    _governance;
+    get governance() {
+        return (this._governance ??= new InternalGovernance(this._client));
+    }
 }
 export class InternalSubscriptions {
     _client;
@@ -38,6 +48,84 @@ export class InternalSubscriptions {
         return unwrap(await createSubscriptionAddon(this._client, request, options));
     }
 }
+export class InternalInvoices {
+    _client;
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * List 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.
+     *
+     * GET /openmeter/billing/invoices
+     */
+    async list(request, options) {
+        return unwrap(await listInvoices(this._client, request, options));
+    }
+    /**
+     * List 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.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/billing/invoices
+     */
+    listAll(request, options) {
+        return paginatePages((req, opts) => listInvoices(this._client, req, opts), request ?? {}, options);
+    }
+    /**
+     * Get a billing invoice
+     *
+     * Get a billing invoice by ID.
+     *
+     * Returns the full invoice resource including line items, status details, totals,
+     * and workflow configuration snapshot.
+     *
+     * GET /openmeter/billing/invoices/{invoiceId}
+     */
+    async get(request, options) {
+        return unwrap(await getInvoice(this._client, request, options));
+    }
+    /**
+     * Update a billing invoice
+     *
+     * 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.
+     *
+     * PUT /openmeter/billing/invoices/{invoiceId}
+     */
+    async update(request, options) {
+        return unwrap(await updateInvoice(this._client, request, options));
+    }
+    /**
+     * Delete a billing invoice
+     *
+     * 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 /openmeter/billing/invoices/{invoiceId}
+     */
+    async delete(request, options) {
+        return unwrap(await deleteInvoice(this._client, request, options));
+    }
+}
 export class InternalCurrencies {
     _client;
     constructor(_client) {
@@ -111,3 +199,26 @@ export class InternalCurrencies {
         return unwrap(await createCostBasis(this._client, request, options));
     }
 }
+export class InternalGovernance {
+    _client;
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * Query governance access
+     *
+     * Query feature access for a list of customers.
+     *
+     * The endpoint resolves each provided identifier to a customer and returns the
+     * access status for the requested features, plus optional credit balance
+     * availability.
+     *
+     * _Designed to be called on a fixed refresh interval and the query response is
+     * intended to be cached._
+     *
+     * POST /openmeter/governance/query
+     */
+    async queryAccess(request, options) {
+        return unwrap(await queryGovernanceAccess(this._client, request, options));
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmeter/client",
-  "version": "1.0.0-beta-1d51ec73a3d5",
+  "version": "1.0.0-beta-05de7df7a13f",
   "description": "Official TypeScript SDK for the OpenMeter API — usage metering and billing",
   "keywords": [
     "openmeter",