@openmeter/client 1.0.0-beta.232 → 1.0.0-beta.234

package/dist/sdk/invoices.d.ts

@@ -1,15 +1,127 @@
 import { type Client } from '../core.js';
 import { type RequestOptions } from '../lib/types.js';
 import type { ListInvoicesRequest, ListInvoicesResponse, GetInvoiceRequest, GetInvoiceResponse, UpdateInvoiceRequest, UpdateInvoiceResponse, DeleteInvoiceRequest, DeleteInvoiceResponse, AdvanceInvoiceRequest, AdvanceInvoiceResponse, ApproveInvoiceRequest, ApproveInvoiceResponse, RetryInvoiceRequest, RetryInvoiceResponse, SnapshotQuantitiesInvoiceRequest, SnapshotQuantitiesInvoiceResponse } from '../models/operations/invoices.js';
+import type { Invoice } from '../models/types.js';
 export declare class Invoices {
     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>;
+    /**
+     * Advance billing invoice's next status
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/advance
+     */
     advance(request: AdvanceInvoiceRequest, options?: RequestOptions): Promise<AdvanceInvoiceResponse>;
+    /**
+     * Send the invoice to the customer
+     *
+     * 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
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/approve
+     */
     approve(request: ApproveInvoiceRequest, options?: RequestOptions): Promise<ApproveInvoiceResponse>;
+    /**
+     * Retry advancing the invoice after a failed attempt
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/retry
+     */
     retry(request: RetryInvoiceRequest, options?: RequestOptions): Promise<RetryInvoiceResponse>;
+    /**
+     * Snapshot quantities for usage based line items
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/snapshot-quantities
+     */
     snapshotQuantities(request: SnapshotQuantitiesInvoiceRequest, options?: RequestOptions): Promise<SnapshotQuantitiesInvoiceResponse>;
 }

package/dist/sdk/invoices.js

@@ -1,31 +1,146 @@
+// Code generated by @openmeter/typespec-typescript. DO NOT EDIT.
 import { unwrap } from '../lib/types.js';
+import { paginatePages } from '../lib/paginate.js';
 import { listInvoices, getInvoice, updateInvoice, deleteInvoice, advanceInvoice, approveInvoice, retryInvoice, snapshotQuantitiesInvoice, } from '../funcs/invoices.js';
 export class Invoices {
     _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));
     }
+    /**
+     * Advance billing invoice's next status
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/advance
+     */
     async advance(request, options) {
         return unwrap(await advanceInvoice(this._client, request, options));
     }
+    /**
+     * Send the invoice to the customer
+     *
+     * 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
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/approve
+     */
     async approve(request, options) {
         return unwrap(await approveInvoice(this._client, request, options));
     }
+    /**
+     * Retry advancing the invoice after a failed attempt
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/retry
+     */
     async retry(request, options) {
         return unwrap(await retryInvoice(this._client, request, options));
     }
+    /**
+     * Snapshot quantities for usage based line items
+     *
+     * 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.
+     *
+     * POST /openmeter/billing/invoices/{invoiceId}/snapshot-quantities
+     */
     async snapshotQuantities(request, options) {
         return unwrap(await snapshotQuantitiesInvoice(this._client, request, options));
     }

package/dist/sdk/notifications.d.ts

@@ -0,0 +1,58 @@
+import { type Client } from '../core.js';
+import { type RequestOptions } from '../lib/types.js';
+import type { ListNotificationChannelsRequest, ListNotificationChannelsResponse, CreateNotificationChannelRequest, CreateNotificationChannelResponse, GetNotificationChannelRequest, GetNotificationChannelResponse, UpdateNotificationChannelRequest, UpdateNotificationChannelResponse, DeleteNotificationChannelRequest, DeleteNotificationChannelResponse } from '../models/operations/notifications.js';
+import type { NotificationChannel } from '../models/types.js';
+export declare class Notifications {
+    private readonly _client;
+    constructor(_client: Client);
+    /**
+     * List notification channels
+     *
+     * List all notification channels.
+     *
+     * GET /openmeter/notification/channels
+     */
+    listChannels(request?: ListNotificationChannelsRequest, options?: RequestOptions): Promise<ListNotificationChannelsResponse>;
+    /**
+     * List notification channels
+     *
+     * List all notification channels.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/notification/channels
+     */
+    listChannelsAll(request?: ListNotificationChannelsRequest, options?: RequestOptions): AsyncIterable<NotificationChannel>;
+    /**
+     * Create notification channel
+     *
+     * Create a notification channel.
+     *
+     * POST /openmeter/notification/channels
+     */
+    createChannel(request: CreateNotificationChannelRequest, options?: RequestOptions): Promise<CreateNotificationChannelResponse>;
+    /**
+     * Get notification channel
+     *
+     * Get a notification channel by id.
+     *
+     * GET /openmeter/notification/channels/{notificationChannelId}
+     */
+    getChannel(request: GetNotificationChannelRequest, options?: RequestOptions): Promise<GetNotificationChannelResponse>;
+    /**
+     * Update notification channel
+     *
+     * Update a notification channel by id.
+     *
+     * PUT /openmeter/notification/channels/{notificationChannelId}
+     */
+    updateChannel(request: UpdateNotificationChannelRequest, options?: RequestOptions): Promise<UpdateNotificationChannelResponse>;
+    /**
+     * Delete notification channel
+     *
+     * Delete a notification channel by id.
+     *
+     * DELETE /openmeter/notification/channels/{notificationChannelId}
+     */
+    deleteChannel(request: DeleteNotificationChannelRequest, options?: RequestOptions): Promise<DeleteNotificationChannelResponse>;
+}

package/dist/sdk/notifications.js

@@ -0,0 +1,72 @@
+// Code generated by @openmeter/typespec-typescript. DO NOT EDIT.
+import { unwrap } from '../lib/types.js';
+import { paginatePages } from '../lib/paginate.js';
+import { listNotificationChannels, createNotificationChannel, getNotificationChannel, updateNotificationChannel, deleteNotificationChannel, } from '../funcs/notifications.js';
+export class Notifications {
+    _client;
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * List notification channels
+     *
+     * List all notification channels.
+     *
+     * GET /openmeter/notification/channels
+     */
+    async listChannels(request, options) {
+        return unwrap(await listNotificationChannels(this._client, request, options));
+    }
+    /**
+     * List notification channels
+     *
+     * List all notification channels.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/notification/channels
+     */
+    listChannelsAll(request, options) {
+        return paginatePages((req, opts) => listNotificationChannels(this._client, req, opts), request ?? {}, options);
+    }
+    /**
+     * Create notification channel
+     *
+     * Create a notification channel.
+     *
+     * POST /openmeter/notification/channels
+     */
+    async createChannel(request, options) {
+        return unwrap(await createNotificationChannel(this._client, request, options));
+    }
+    /**
+     * Get notification channel
+     *
+     * Get a notification channel by id.
+     *
+     * GET /openmeter/notification/channels/{notificationChannelId}
+     */
+    async getChannel(request, options) {
+        return unwrap(await getNotificationChannel(this._client, request, options));
+    }
+    /**
+     * Update notification channel
+     *
+     * Update a notification channel by id.
+     *
+     * PUT /openmeter/notification/channels/{notificationChannelId}
+     */
+    async updateChannel(request, options) {
+        return unwrap(await updateNotificationChannel(this._client, request, options));
+    }
+    /**
+     * Delete notification channel
+     *
+     * Delete a notification channel by id.
+     *
+     * DELETE /openmeter/notification/channels/{notificationChannelId}
+     */
+    async deleteChannel(request, options) {
+        return unwrap(await deleteNotificationChannel(this._client, request, options));
+    }
+}

package/dist/sdk/planAddons.d.ts

@@ -1,28 +1,9 @@
 import { type Client } from '../core.js';
 import { type RequestOptions } from '../lib/types.js';
-import type { ListPlanAddonsRequest, ListPlanAddonsResponse, CreatePlanAddonRequest, CreatePlanAddonResponse, GetPlanAddonRequest, GetPlanAddonResponse, UpdatePlanAddonRequest, UpdatePlanAddonResponse, DeletePlanAddonRequest, DeletePlanAddonResponse } from '../models/operations/planAddons.js';
-import type { PlanAddon } from '../models/types.js';
+import type { CreatePlanAddonRequest, CreatePlanAddonResponse, GetPlanAddonRequest, GetPlanAddonResponse, UpdatePlanAddonRequest, UpdatePlanAddonResponse, DeletePlanAddonRequest, DeletePlanAddonResponse } from '../models/operations/planAddons.js';
 export declare class PlanAddons {
     private readonly _client;
     constructor(_client: Client);
-    /**
-     * List add-ons for plan
-     *
-     * List add-ons associated with a plan.
-     *
-     * GET /openmeter/plans/{planId}/addons
-     */
-    list(request: ListPlanAddonsRequest, options?: RequestOptions): Promise<ListPlanAddonsResponse>;
-    /**
-     * List add-ons for plan
-     *
-     * List add-ons associated with a plan.
-     *
-     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
-     *
-     * GET /openmeter/plans/{planId}/addons
-     */
-    listAll(request: ListPlanAddonsRequest, options?: RequestOptions): AsyncIterable<PlanAddon>;
     /**
      * Add add-on to plan
      *

package/dist/sdk/planAddons.js

@@ -1,34 +1,11 @@
 // Code generated by @openmeter/typespec-typescript. DO NOT EDIT.
 import { unwrap } from '../lib/types.js';
-import { paginatePages } from '../lib/paginate.js';
-import { listPlanAddons, createPlanAddon, getPlanAddon, updatePlanAddon, deletePlanAddon, } from '../funcs/planAddons.js';
+import { createPlanAddon, getPlanAddon, updatePlanAddon, deletePlanAddon, } from '../funcs/planAddons.js';
 export class PlanAddons {
     _client;
     constructor(_client) {
         this._client = _client;
     }
-    /**
-     * List add-ons for plan
-     *
-     * List add-ons associated with a plan.
-     *
-     * GET /openmeter/plans/{planId}/addons
-     */
-    async list(request, options) {
-        return unwrap(await listPlanAddons(this._client, request, options));
-    }
-    /**
-     * List add-ons for plan
-     *
-     * List add-ons associated with a plan.
-     *
-     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
-     *
-     * GET /openmeter/plans/{planId}/addons
-     */
-    listAll(request, options) {
-        return paginatePages((req, opts) => listPlanAddons(this._client, req, opts), request, options);
-    }
     /**
      * Add add-on to plan
      *

package/dist/sdk/sdk.d.ts

@@ -4,6 +4,7 @@ import { Meters } from './meters.js';
 import { Customers } from './customers.js';
 import { Entitlements } from './entitlements.js';
 import { Subscriptions } from './subscriptions.js';
+import { Apps } from './apps.js';
 import { Billing } from './billing.js';
 import { Tax } from './tax.js';
 import { Features } from './features.js';
@@ -24,6 +25,8 @@ export declare class OpenMeter extends Client {
     get entitlements(): Entitlements;
     private _subscriptions?;
     get subscriptions(): Subscriptions;
+    private _apps?;
+    get apps(): Apps;
     private _billing?;
     get billing(): Billing;
     private _tax?;

package/dist/sdk/sdk.js

@@ -5,6 +5,7 @@ import { Meters } from './meters.js';
 import { Customers } from './customers.js';
 import { Entitlements } from './entitlements.js';
 import { Subscriptions } from './subscriptions.js';
+import { Apps } from './apps.js';
 import { Billing } from './billing.js';
 import { Tax } from './tax.js';
 import { Features } from './features.js';
@@ -35,6 +36,10 @@ export class OpenMeter extends Client {
     get subscriptions() {
         return (this._subscriptions ??= new Subscriptions(this));
     }
+    _apps;
+    get apps() {
+        return (this._apps ??= new Apps(this));
+    }
     _billing;
     get billing() {
         return (this._billing ??= new Billing(this));

package/dist/sdk/subscriptions.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from '../core.js';
 import { type RequestOptions } from '../lib/types.js';
-import type { CreateSubscriptionRequest, CreateSubscriptionResponse, ListSubscriptionsRequest, ListSubscriptionsResponse, GetSubscriptionRequest, GetSubscriptionResponse, CancelSubscriptionRequest, CancelSubscriptionResponse, UnscheduleCancelationRequest, UnscheduleCancelationResponse, ChangeSubscriptionRequest, ChangeSubscriptionResponse, ListSubscriptionAddonsRequest, ListSubscriptionAddonsResponse, GetSubscriptionAddonRequest, GetSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
+import type { CreateSubscriptionRequest, CreateSubscriptionResponse, ListSubscriptionsRequest, ListSubscriptionsResponse, GetSubscriptionRequest, GetSubscriptionResponse, CancelSubscriptionRequest, CancelSubscriptionResponse, UnscheduleCancelationRequest, UnscheduleCancelationResponse, ChangeSubscriptionRequest, ChangeSubscriptionResponse, EditSubscriptionRequest, EditSubscriptionResponse, ListSubscriptionAddonsRequest, ListSubscriptionAddonsResponse, GetSubscriptionAddonRequest, GetSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
 import type { Subscription, SubscriptionAddon } from '../models/types.js';
 export declare class Subscriptions {
     private readonly _client;
@@ -57,6 +57,17 @@ export declare class Subscriptions {
      * POST /openmeter/subscriptions/{subscriptionId}/change
      */
     change(request: ChangeSubscriptionRequest, options?: RequestOptions): Promise<ChangeSubscriptionResponse>;
+    /**
+     * Edit subscription
+     *
+     * Edits a running subscription by applying an ordered batch of customizations
+     * (adding or removing items, adding, removing, or stretching phases, or
+     * unscheduling a pending edit). The changes may take effect immediately or at the
+     * next billing cycle. Subscriptions that have add-ons cannot be edited.
+     *
+     * POST /openmeter/subscriptions/{subscriptionId}/edit
+     */
+    edit(request: EditSubscriptionRequest, options?: RequestOptions): Promise<EditSubscriptionResponse>;
     /**
      * List subscription addons
      *

package/dist/sdk/subscriptions.js

@@ -1,7 +1,7 @@
 // Code generated by @openmeter/typespec-typescript. DO NOT EDIT.
 import { unwrap } from '../lib/types.js';
 import { paginatePages } from '../lib/paginate.js';
-import { createSubscription, listSubscriptions, getSubscription, cancelSubscription, unscheduleCancelation, changeSubscription, listSubscriptionAddons, getSubscriptionAddon, } from '../funcs/subscriptions.js';
+import { createSubscription, listSubscriptions, getSubscription, cancelSubscription, unscheduleCancelation, changeSubscription, editSubscription, listSubscriptionAddons, getSubscriptionAddon, } from '../funcs/subscriptions.js';
 export class Subscriptions {
     _client;
     constructor(_client) {
@@ -73,6 +73,19 @@ export class Subscriptions {
     async change(request, options) {
         return unwrap(await changeSubscription(this._client, request, options));
     }
+    /**
+     * Edit subscription
+     *
+     * Edits a running subscription by applying an ordered batch of customizations
+     * (adding or removing items, adding, removing, or stretching phases, or
+     * unscheduling a pending edit). The changes may take effect immediately or at the
+     * next billing cycle. Subscriptions that have add-ons cannot be edited.
+     *
+     * POST /openmeter/subscriptions/{subscriptionId}/edit
+     */
+    async edit(request, options) {
+        return unwrap(await editSubscription(this._client, request, options));
+    }
     /**
      * List subscription addons
      *

package/package.json

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

package/dist/models/operations/governance.d.ts

@@ -1,9 +0,0 @@
-import type { AcceptDateStrings } from '../../lib/wire.js';
-import type { CursorPaginationQueryPage, GovernanceQueryRequestInput, GovernanceQueryResponse } from '../types.js';
-export interface QueryGovernanceAccessQuery {
-    page?: CursorPaginationQueryPage;
-}
-export type QueryGovernanceAccessRequest = AcceptDateStrings<{
-    body: GovernanceQueryRequestInput;
-} & QueryGovernanceAccessQuery>;
-export type QueryGovernanceAccessResponse = GovernanceQueryResponse;