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

package/dist/funcs/subscriptions.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from '../core.js';
 import { type Result, type RequestOptions } from '../lib/types.js';
-import type { CreateSubscriptionRequest, CreateSubscriptionResponse, ListSubscriptionsRequest, ListSubscriptionsResponse, GetSubscriptionRequest, GetSubscriptionResponse, CancelSubscriptionRequest, CancelSubscriptionResponse, UnscheduleCancelationRequest, UnscheduleCancelationResponse, ChangeSubscriptionRequest, ChangeSubscriptionResponse, CreateSubscriptionAddonRequest, CreateSubscriptionAddonResponse, ListSubscriptionAddonsRequest, ListSubscriptionAddonsResponse, GetSubscriptionAddonRequest, GetSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
+import type { CreateSubscriptionRequest, CreateSubscriptionResponse, ListSubscriptionsRequest, ListSubscriptionsResponse, GetSubscriptionRequest, GetSubscriptionResponse, CancelSubscriptionRequest, CancelSubscriptionResponse, UnscheduleCancelationRequest, UnscheduleCancelationResponse, UnscheduleSubscriptionRequest, UnscheduleSubscriptionResponse, RestoreSubscriptionRequest, RestoreSubscriptionResponse, ChangeSubscriptionRequest, ChangeSubscriptionResponse, MigrateSubscriptionRequest, MigrateSubscriptionResponse, EditSubscriptionRequest, EditSubscriptionResponse, CreateSubscriptionAddonRequest, CreateSubscriptionAddonResponse, ListSubscriptionAddonsRequest, ListSubscriptionAddonsResponse, GetSubscriptionAddonRequest, GetSubscriptionAddonResponse, UpdateSubscriptionAddonRequest, UpdateSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
 /**
  * Create subscription
  *
@@ -36,6 +36,29 @@ export declare function cancelSubscription(client: Client, req: CancelSubscripti
  * POST /openmeter/subscriptions/{subscriptionId}/unschedule-cancelation
  */
 export declare function unscheduleCancelation(client: Client, req: UnscheduleCancelationRequest, options?: RequestOptions): Promise<Result<UnscheduleCancelationResponse>>;
+/**
+ * Unschedule subscription
+ *
+ * Deletes a scheduled subscription that has not yet become active, removing it and
+ * resolving any scheduling conflict it was holding. This is distinct from
+ * canceling: cancel ends a running subscription, whereas unscheduling removes a
+ * not-yet-active one. Only scheduled subscriptions can be unscheduled;
+ * unscheduling an active or already-started subscription is rejected.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/unschedule
+ */
+export declare function unscheduleSubscription(client: Client, req: UnscheduleSubscriptionRequest, options?: RequestOptions): Promise<Result<UnscheduleSubscriptionResponse>>;
+/**
+ * Restore subscription
+ *
+ * Restores the subscription by deleting any later-scheduled successor
+ * subscriptions and continuing this one indefinitely. This is the inverse of a
+ * future-dated change, which schedules a successor. Restore is not available when
+ * multi-subscription is enabled.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/restore
+ */
+export declare function restoreSubscription(client: Client, req: RestoreSubscriptionRequest, options?: RequestOptions): Promise<Result<RestoreSubscriptionResponse>>;
 /**
  * Change subscription
  *
@@ -45,6 +68,32 @@ export declare function unscheduleCancelation(client: Client, req: UnscheduleCan
  * POST /openmeter/subscriptions/{subscriptionId}/change
  */
 export declare function changeSubscription(client: Client, req: ChangeSubscriptionRequest, options?: RequestOptions): Promise<Result<ChangeSubscriptionResponse>>;
+/**
+ * Migrate subscription
+ *
+ * Migrates to a later version of the current plan. With starting_phase omitted and
+ * billing_anchor omitted or unchanged, migration amends the subscription in place:
+ * unchanged items retain their service periods and both response entries have the
+ * same ID. Existing addons must remain compatible with the target plan.
+ * Incompatible phase timelines or billing settings return an error. Providing
+ * starting_phase or a different billing_anchor explicitly requests replacement,
+ * which resets the phase timeline, may produce billing adjustments, and does not
+ * transfer addons. Custom subscriptions cannot be migrated.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/migrate
+ */
+export declare function migrateSubscription(client: Client, req: MigrateSubscriptionRequest, options?: RequestOptions): Promise<Result<MigrateSubscriptionResponse>>;
+/**
+ * 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
+ */
+export declare function editSubscription(client: Client, req: EditSubscriptionRequest, options?: RequestOptions): Promise<Result<EditSubscriptionResponse>>;
 /**
  * Create a new subscription add-on
  *
@@ -69,3 +118,13 @@ export declare function listSubscriptionAddons(client: Client, req: ListSubscrip
  * GET /openmeter/subscriptions/{subscriptionId}/addons/{subscriptionAddonId}
  */
 export declare function getSubscriptionAddon(client: Client, req: GetSubscriptionAddonRequest, options?: RequestOptions): Promise<Result<GetSubscriptionAddonResponse>>;
+/**
+ * Update subscription addon
+ *
+ * Update a subscription add-on. Only the quantity is mutable; the timing controls
+ * when the new quantity takes effect. A new entry is appended to the add-on's
+ * timeline.
+ *
+ * PATCH /openmeter/subscriptions/{subscriptionId}/addons/{subscriptionAddonId}
+ */
+export declare function updateSubscriptionAddon(client: Client, req: UpdateSubscriptionAddonRequest, options?: RequestOptions): Promise<Result<UpdateSubscriptionAddonResponse>>;

package/dist/funcs/subscriptions.js

@@ -164,6 +164,75 @@ export function unscheduleCancelation(client, req, options) {
         });
     });
 }
+/**
+ * Unschedule subscription
+ *
+ * Deletes a scheduled subscription that has not yet become active, removing it and
+ * resolving any scheduling conflict it was holding. This is distinct from
+ * canceling: cancel ends a running subscription, whereas unscheduling removes a
+ * not-yet-active one. Only scheduled subscriptions can be unscheduled;
+ * unscheduling an active or already-started subscription is rejected.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/unschedule
+ */
+export function unscheduleSubscription(client, req, options) {
+    return request(async () => {
+        const pathParamsInput = {
+            subscriptionId: req.subscriptionId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.unscheduleSubscriptionPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.unscheduleSubscriptionPathParamsWire, pathParams);
+        }
+        const path = `openmeter/subscriptions/${(() => {
+            if (pathParams.subscriptionId === undefined) {
+                throw new Error('missing path parameter: subscriptionId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionId));
+        })()}/unschedule`;
+        await http(client).post(path, options);
+    });
+}
+/**
+ * Restore subscription
+ *
+ * Restores the subscription by deleting any later-scheduled successor
+ * subscriptions and continuing this one indefinitely. This is the inverse of a
+ * future-dated change, which schedules a successor. Restore is not available when
+ * multi-subscription is enabled.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/restore
+ */
+export function restoreSubscription(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            subscriptionId: req.subscriptionId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.restoreSubscriptionPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.restoreSubscriptionPathParamsWire, pathParams);
+        }
+        const path = `openmeter/subscriptions/${(() => {
+            if (pathParams.subscriptionId === undefined) {
+                throw new Error('missing path parameter: subscriptionId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionId));
+        })()}/restore`;
+        return http(client)
+            .post(path, options)
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.restoreSubscriptionResponseWire, data);
+            }
+            return fromWire(data, schemas.restoreSubscriptionResponse);
+        });
+    });
+}
 /**
  * Change subscription
  *
@@ -204,6 +273,94 @@ export function changeSubscription(client, req, options) {
         });
     });
 }
+/**
+ * Migrate subscription
+ *
+ * Migrates to a later version of the current plan. With starting_phase omitted and
+ * billing_anchor omitted or unchanged, migration amends the subscription in place:
+ * unchanged items retain their service periods and both response entries have the
+ * same ID. Existing addons must remain compatible with the target plan.
+ * Incompatible phase timelines or billing settings return an error. Providing
+ * starting_phase or a different billing_anchor explicitly requests replacement,
+ * which resets the phase timeline, may produce billing adjustments, and does not
+ * transfer addons. Custom subscriptions cannot be migrated.
+ *
+ * POST /openmeter/subscriptions/{subscriptionId}/migrate
+ */
+export function migrateSubscription(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            subscriptionId: req.subscriptionId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.migrateSubscriptionPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.migrateSubscriptionPathParamsWire, pathParams);
+        }
+        const path = `openmeter/subscriptions/${(() => {
+            if (pathParams.subscriptionId === undefined) {
+                throw new Error('missing path parameter: subscriptionId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionId));
+        })()}/migrate`;
+        const body = toWire(req.body, schemas.migrateSubscriptionBody);
+        if (client._options.validate) {
+            assertValid(schemas.migrateSubscriptionBodyWire, body);
+        }
+        return http(client)
+            .post(path, { ...options, json: body })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.migrateSubscriptionResponseWire, data);
+            }
+            return fromWire(data, schemas.migrateSubscriptionResponse);
+        });
+    });
+}
+/**
+ * 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
+ */
+export function editSubscription(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            subscriptionId: req.subscriptionId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.editSubscriptionPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.editSubscriptionPathParamsWire, pathParams);
+        }
+        const path = `openmeter/subscriptions/${(() => {
+            if (pathParams.subscriptionId === undefined) {
+                throw new Error('missing path parameter: subscriptionId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionId));
+        })()}/edit`;
+        const body = toWire(req.body, schemas.editSubscriptionBody);
+        if (client._options.validate) {
+            assertValid(schemas.editSubscriptionBodyWire, body);
+        }
+        return http(client)
+            .post(path, { ...options, json: body })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.editSubscriptionResponseWire, data);
+            }
+            return fromWire(data, schemas.editSubscriptionResponse);
+        });
+    });
+}
 /**
  * Create a new subscription add-on
  *
@@ -330,3 +487,50 @@ export function getSubscriptionAddon(client, req, options) {
         });
     });
 }
+/**
+ * Update subscription addon
+ *
+ * Update a subscription add-on. Only the quantity is mutable; the timing controls
+ * when the new quantity takes effect. A new entry is appended to the add-on's
+ * timeline.
+ *
+ * PATCH /openmeter/subscriptions/{subscriptionId}/addons/{subscriptionAddonId}
+ */
+export function updateSubscriptionAddon(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            subscriptionId: req.subscriptionId,
+            subscriptionAddonId: req.subscriptionAddonId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.updateSubscriptionAddonPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.updateSubscriptionAddonPathParamsWire, pathParams);
+        }
+        const path = `openmeter/subscriptions/${(() => {
+            if (pathParams.subscriptionId === undefined) {
+                throw new Error('missing path parameter: subscriptionId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionId));
+        })()}/addons/${(() => {
+            if (pathParams.subscriptionAddonId === undefined) {
+                throw new Error('missing path parameter: subscriptionAddonId');
+            }
+            return encodeURIComponent(String(pathParams.subscriptionAddonId));
+        })()}`;
+        const body = toWire(req.body, schemas.updateSubscriptionAddonBody);
+        if (client._options.validate) {
+            assertValid(schemas.updateSubscriptionAddonBodyWire, body);
+        }
+        return http(client)
+            .patch(path, { ...options, json: body })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.updateSubscriptionAddonResponseWire, data);
+            }
+            return fromWire(data, schemas.updateSubscriptionAddonResponse);
+        });
+    });
+}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { Meters } from './sdk/meters.js';
 export { Customers } from './sdk/customers.js';
 export { Entitlements } from './sdk/entitlements.js';
 export { Subscriptions } from './sdk/subscriptions.js';
+export { Apps } from './sdk/apps.js';
 export { Billing } from './sdk/billing.js';
 export { Tax } from './sdk/tax.js';
 export { Features } from './sdk/features.js';
@@ -31,6 +32,7 @@ export type * from './models/operations/subscriptions.js';
 export type * from './models/operations/apps.js';
 export type * from './models/operations/billing.js';
 export type * from './models/operations/invoices.js';
+export type * from './models/operations/charges.js';
 export type * from './models/operations/tax.js';
 export type * from './models/operations/currencies.js';
 export type * from './models/operations/features.js';
@@ -39,5 +41,5 @@ export type * from './models/operations/plans.js';
 export type * from './models/operations/addons.js';
 export type * from './models/operations/planAddons.js';
 export type * from './models/operations/defaults.js';
-export type * from './models/operations/governance.js';
-export type { Labels, CursorPaginationQueryPage, SortQuery, IngestedEventValidationError, CursorMetaPage, BaseError, PageMeta, QueryFilterString, AppStripeCheckoutSessionCustomTextParams, AppStripeCreateCustomerPortalSessionOptions, CreateLabels, TaxConfigStripe, TaxConfigExternalInvoicing, ChargeFlatFeeDiscounts, PriceFree, RateCardStaticEntitlement, RateCardBooleanEntitlement, UpdateLabels, InstallAppStripeWithApiKey, InstallAppSandbox, InstallAppExternalInvoicing, WorkflowCollectionAlignmentSubscription, WorkflowPaymentChargeAutomaticallySettings, WorkflowPaymentSendInvoiceSettings, InvoiceExternalReferences, InvoiceAvailableActionDetails, InvoiceWorkflowInvoicingSettings, InvoiceLineExternalReferences, UpdateBillingInvoiceWorkflowInvoicingSettings, UpdateBillingWorkflowPaymentChargeAutomaticallySettings, UpdateBillingWorkflowPaymentSendInvoiceSettings, UpdatePriceFree, LlmCostProvider, LlmCostModel, ProductCatalogValidationError, GovernanceQueryRequestCustomers, GovernanceQueryRequestFeatures, QueryFilterInteger, QueryFilterFloat, QueryFilterBoolean, PagePaginationQuery, PublicLabels, SystemAccountAccessToken, PersonalAccessToken, KonnectAccessToken, AppCustomerDataStripe, AppCustomerDataExternalInvoicing, CurrencyFiat, ListCostBasesParamsFilter, CreateCurrencyCustomRequest, CurrencyAmount, PriceFlat, PriceUnit, RateCardDiscounts, Totals, SpendCommitments, InvoiceLineCreditsApplied, UpdatePriceFlat, UpdatePriceUnit, UpdateDiscounts, FeatureManualUnitCost, FeatureLlmUnitCostPricing, LlmCostModelPricing, QueryFilterNumeric, CursorPaginationQuery, ListMetersParamsFilter, ListLlmCostPricesParamsFilter, LabelsFieldFilter, CustomerReference, ProfileReference, CreateResourceReference, TaxCodeReference, CreditGrantInvoiceReference, BillingCustomerReference, SubscriptionReference, AddonReference, FeatureReference, AppReference, ChargeReference, UpdateResourceReference, Event, MeterQueryRow, AppStripeCreateCustomerPortalSessionResult, ClosedPeriod, SubscriptionAddonTimelineSegment, UpdateClosedPeriod, CostBasis, FeatureCostQueryRow, Resource, ResourceImmutable, QueryFilterDateTime, CursorMeta, InvalidParameterStandard, InvalidParameterMinimumLength, InvalidParameterMaximumLength, InvalidParameterChoiceItem, InvalidParameterDependentItem, Unauthorized, Forbidden, NotFound, Gone, Conflict, PayloadTooLarge, UnsupportedMediaType, UnprocessableContent, TooManyRequests, Internal, NotImplemented, NotAvailable, CreateCreditGrantFilters, CreditGrantFilters, UpsertPlanAddonRequest, ResourceWithKey, Meter, PaginatedMeta, QueryFilterStringMapItem, CustomerKeyReference, CustomerUsageAttribution, UpdateCustomerUsageAttribution, Address, UpdateAddress, AppStripeCreateCheckoutSessionCustomerUpdate, AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement, AppStripeCreateCheckoutSessionTaxIdCollection, AppStripeCreateCheckoutSessionResult, CustomerStripeCreateCustomerPortalSessionRequest, EntitlementAccessResult, CreateCreditGrantPurchase, RateCardMeteredEntitlement, RecurringPeriod, CreditGrantPurchase, ListCreditGrantsParamsFilter, GetCreditBalanceParamsFilter, ListChargesParamsFilter, ListPlansParamsFilter, SubscriptionCreate, RateCardProrationConfiguration, Subscription, UnitConfig, TaxCodeAppMapping, AppCapability, UpdateAppStripeRequest, UpdateAppSandboxRequest, UpdateAppExternalInvoicingRequest, PartyTaxIdentity, UpdateBillingPartyTaxIdentity, WorkflowInvoicingSettings, InvoiceValidationIssue, InvoiceAvailableActions, InvoiceLineAmountDiscount, InvoiceLineUsageDiscount, InvoiceLineBaseDiscount, ListCurrenciesParamsFilter, GovernanceQueryRequest, GovernanceFeatureAccessReason, GovernanceQueryError, AppCustomerData, UpsertAppCustomerDataRequest, CreditAdjustment, CreditBalance, ListCreditTransactionsParamsFilter, CreditTransaction, PriceTier, ChargeTotals, UpdatePriceTier, FeatureLlmUnitCost, LlmCostPrice, LlmCostOverrideCreate, ListCustomersParamsFilter, ListSubscriptionsParamsFilter, ListFeatureParamsFilter, ListAddonsParamsFilter, CreateCreditGrantTaxConfig, CreditGrantTaxConfig, TaxConfig, RateCardTaxConfig, OrganizationDefaultTaxCodes, PlanAddon, ProfileAppReferences, InvoiceWorkflowAppsReferences, UpdateRateCardTaxConfig, ListEventsParamsFilter, ListInvoicesParamsFilter, ResourceFilters, FieldFilters, IngestedEvent, MeterQueryResult, CurrencyCustom, FeatureCostQueryResult, MeterPagePaginatedResponse, CostBasisPagePaginatedResponse, MeterQueryFilters, FeatureMeterReference, Customer, PartyAddresses, InvoiceCustomer, UpdateBillingPartyAddresses, UpdateInvoiceCustomer, AppStripeCreateCheckoutSessionConsentCollection, ListCustomerEntitlementAccessResponseData, WorkflowCollectionAlignmentAnchored, ChargeFlatFeeSystemIntent, SubscriptionPagePaginatedResponse, SubscriptionChangeResponse, SubscriptionCancel, SubscriptionChange, InvoiceUsageQuantityDetail, TaxCode, AppCatalogItem, InvoiceWorkflow, InvoiceStatusDetails, InvoiceLineDiscounts, UpdateBillingInvoiceWorkflow, GovernanceFeatureAccess, CustomerData, UpsertCustomerBillingDataRequest, CreditBalances, CreditTransactionPaginatedResponse, PriceGraduated, PriceVolume, UpdatePriceGraduated, UpdatePriceVolume, PricePagePaginatedResponse, CreditGrant, CreateChargeFlatFeeRequest, WorkflowTaxSettings, PlanAddonPagePaginatedResponse, IngestedEventPaginatedResponse, InvalidParameters, MeterQueryRequest, CustomerPagePaginatedResponse, Party, Supplier, UpdateSupplier, AppStripeCreateCheckoutSessionRequestOptions, TaxCodePagePaginatedResponse, AppStripe, AppSandbox, AppExternalInvoicing, AppCatalogItemPagePaginatedResponse, InvoiceWorkflowSettings, InvoiceDetailedLine, UpdateInvoiceWorkflowSettings, GovernanceQueryResult, Feature, CreditGrantPagePaginatedResponse, CurrencyPagePaginatedResponse, BadRequest, InvoiceBase, CustomerStripeCreateCheckoutSessionRequest, WorkflowCollectionSettings, GovernanceQueryResponse, ChargeFlatFee, ChargeUsageBasedSystemIntent, CreateChargeUsageBasedRequest, RateCard, InvoiceLineRateCard, UpdateInvoiceLineRateCard, FeaturePagePaginatedResponse, Workflow, AppPagePaginatedResponse, BillingInstallAppResponse, ProfileApps, ChargeUsageBased, SubscriptionAddonRateCard, PlanPhase, Addon, UpsertAddonRequest, InvoiceStandardLine, UpdateInvoiceStandardLine, Profile, UpsertBillingProfileRequest, SubscriptionAddon, Plan, UpsertPlanRequest, AddonPagePaginatedResponse, ProfilePagePaginatedResponse, ChargePagePaginatedResponse, SubscriptionAddonPagePaginatedResponse, PlanPagePaginatedResponse, InvoiceStandard, UpdateInvoiceStandardRequest, InvoicePagePaginatedResponse, StringFieldFilter, MeterAggregation, MeterQueryGranularity, StringFieldFilterExact, PricePaymentTerm, BillingCurrencyCode, CreateCurrencyCode, UlidFieldFilter, DateTimeFieldFilter, SubscriptionEditTiming, WorkflowPaymentSettings, UpdateBillingWorkflowPaymentSettings, InvalidParameter, RateCardEntitlement, FeatureUnitCost, Currency, WorkflowCollectionAlignment, Price, UpdatePrice, App, CreateChargeRequest, Charge, InvoiceLine, UpdateInvoiceLine, Invoice, SortQueryInput, BaseErrorInput, WorkflowPaymentSendInvoiceSettingsInput, InvoiceWorkflowInvoicingSettingsInput, UpdateBillingInvoiceWorkflowInvoicingSettingsInput, UpdateBillingWorkflowPaymentSendInvoiceSettingsInput, EventInput, UnauthorizedInput, ForbiddenInput, NotFoundInput, GoneInput, ConflictInput, PayloadTooLargeInput, UnsupportedMediaTypeInput, UnprocessableContentInput, TooManyRequestsInput, InternalInput, NotImplementedInput, NotAvailableInput, AppStripeCreateCheckoutSessionCustomerUpdateInput, AppStripeCreateCheckoutSessionTaxIdCollectionInput, CreateCreditGrantPurchaseInput, RateCardMeteredEntitlementInput, CreditGrantPurchaseInput, VoidCreditGrantRequestInput, UnitConfigInput, WorkflowInvoicingSettingsInput, GovernanceQueryRequestInput, IngestedEventInput, SubscriptionCancelInput, InvoiceUsageQuantityDetailInput, InvoiceWorkflowInput, UpdateBillingInvoiceWorkflowInput, CreateCreditGrantRequestInput, CreditGrantInput, WorkflowTaxSettingsInput, IngestedEventPaginatedResponseInput, MeterQueryRequestInput, AppStripeCreateCheckoutSessionRequestOptionsInput, InvoiceWorkflowSettingsInput, InvoiceDetailedLineInput, UpdateInvoiceWorkflowSettingsInput, CreditGrantPagePaginatedResponseInput, BadRequestInput, CustomerStripeCreateCheckoutSessionRequestInput, WorkflowCollectionSettingsInput, RateCardInput, InvoiceLineRateCardInput, WorkflowInput, SubscriptionAddonRateCardInput, PlanPhaseInput, AddonInput, CreateAddonRequestInput, UpsertAddonRequestInput, InvoiceStandardLineInput, ProfileInput, CreateBillingProfileRequestInput, UpsertBillingProfileRequestInput, SubscriptionAddonInput, PlanInput, CreatePlanRequestInput, UpsertPlanRequestInput, AddonPagePaginatedResponseInput, ProfilePagePaginatedResponseInput, SubscriptionAddonPagePaginatedResponseInput, PlanPagePaginatedResponseInput, InvoiceStandardInput, UpdateInvoiceStandardRequestInput, InvoicePagePaginatedResponseInput, WorkflowPaymentSettingsInput, UpdateBillingWorkflowPaymentSettingsInput, RateCardEntitlementInput, InvoiceLineInput, InvoiceInput, UpdateInvoiceRequestInput, } from './models/types.js';
+export type * from './models/operations/entitlementAccess.js';
+export type { Labels, CursorPaginationQueryPage, SortQuery, IngestedEventValidationError, CursorMetaPage, BaseError, PageMeta, QueryFilterString, AppStripeCheckoutSessionCustomTextParams, AppStripeCreateCustomerPortalSessionOptions, CreateLabels, PriceFree, RateCardStaticEntitlement, RateCardBooleanEntitlement, TaxConfigStripe, TaxConfigExternalInvoicing, InvoiceExternalReferences, InvoiceAvailableActionDetails, InvoiceWorkflowInvoicingSettings, WorkflowPaymentChargeAutomaticallySettings, WorkflowPaymentSendInvoiceSettings, ChargeFlatFeeDiscounts, SubscriptionEditRemoveItem, SubscriptionEditUnscheduleEdit, UpdateLabels, InstallAppStripeWithApiKey, InstallAppSandbox, InstallAppExternalInvoicing, WorkflowCollectionAlignmentSubscription, InvoiceLineExternalReferences, UpdateBillingInvoiceWorkflowInvoicingSettings, UpdateBillingWorkflowPaymentChargeAutomaticallySettings, UpdateBillingWorkflowPaymentSendInvoiceSettings, UpdatePriceFree, LlmCostProvider, LlmCostModel, ProductCatalogValidationError, EntitlementAccessQueryRequestCustomers, EntitlementAccessQueryRequestFeatures, QueryFilterInteger, QueryFilterFloat, QueryFilterBoolean, PagePaginationQuery, PublicLabels, SystemAccountAccessToken, PersonalAccessToken, KonnectAccessToken, AppCustomerDataStripe, AppCustomerDataExternalInvoicing, CreateChargeCostBasisDynamic, ChargeCostBasisDynamic, CurrencyFiat, ListCostBasesParamsFilter, CreateCurrencyCustomRequest, EntitlementAccessValue, CreateChargeCostBasisManual, ChargeCostBasisManual, PriceFlat, PriceUnit, SpendCommitments, RateCardDiscounts, Totals, ChargeRealizationDetailedLineCreditApplied, ChargeRealizationAmountDiscount, FeatureManualUnitCost, FeatureLlmUnitCostPricing, InvoiceLineCreditsApplied, InvoiceUsageQuantityDetail, UpdatePriceFlat, UpdatePriceUnit, UpdateDiscounts, LlmCostModelPricing, FiatCurrencyAmount, QueryFilterNumeric, CursorPaginationQuery, ListMetersParamsFilter, ListLlmCostPricesParamsFilter, LabelsFieldFilter, CustomerReference, ProfileReference, CreateChargeCostBasisPinned, CreateResourceReference, ChargeCostBasisPinned, TaxCodeReference, CreditGrantInvoiceReference, SubscriptionCostBasisPin, FeatureReference, SubscriptionReference, AppReference, ChargeRealizationInvoiceReference, AddonReference, ChargeReference, UpdateResourceReference, BillingCustomerReference, ChargeFeature, Event, MeterQueryRow, AppStripeCreateCustomerPortalSessionResult, ChargeResolvedCostBasis, ClosedPeriod, SubscriptionAddonTimelineSegment, UpdateClosedPeriod, CostBasis, FeatureCostQueryRow, Resource, ResourceImmutable, QueryFilterDateTime, CursorMeta, InvalidParameterStandard, InvalidParameterMinimumLength, InvalidParameterMaximumLength, InvalidParameterChoiceItem, InvalidParameterDependentItem, Unauthorized, Forbidden, NotFound, Gone, Conflict, PayloadTooLarge, UnsupportedMediaType, UnprocessableContent, TooManyRequests, Internal, NotImplemented, NotAvailable, CreateCreditGrantFilters, CreditGrantFilters, SubscriptionPlanReference, UpsertPlanAddonRequest, ResourceWithKey, Meter, PaginatedMeta, QueryFilterStringMapItem, CustomerKeyReference, CustomerUsageAttribution, UpdateCustomerUsageAttribution, Address, UpdateAddress, AppStripeCreateCheckoutSessionCustomerUpdate, AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement, AppStripeCreateCheckoutSessionTaxIdCollection, AppStripeCreateCheckoutSessionResult, CustomerStripeCreateCustomerPortalSessionRequest, RateCardMeteredEntitlement, SubscriptionPhaseCreate, SubscriptionEditStretchPhase, RecurringPeriod, ListCreditGrantsParamsFilter, ValidationIssue, GetCreditBalanceParamsFilter, ListPlansParamsFilter, SubscriptionProRatingConfig, RateCardProrationConfiguration, UnitConfig, PartyTaxIdentity, UpdateBillingPartyTaxIdentity, InvoiceAvailableActions, ChargeRealizationPayment, SubscriptionEditRemovePhase, TaxCodeAppMapping, AppCapability, UpdateAppStripeRequest, UpdateAppSandboxRequest, UpdateAppExternalInvoicingRequest, WorkflowInvoicingSettings, InvoiceLineAmountDiscount, InvoiceLineUsageDiscount, InvoiceLineBaseDiscount, ListCurrenciesParamsFilter, EntitlementAccessQueryRequest, EntitlementFeatureAccessReason, EntitlementAccessQueryError, AppCustomerData, UpsertAppCustomerDataRequest, CreditAdjustment, CreditBalance, ListCreditTransactionsParamsFilter, CreditTransaction, CurrencyAmount, EntitlementAccessResult, PriceTier, ChargeTotals, FeatureLlmUnitCost, UpdatePriceTier, LlmCostPrice, LlmCostOverrideCreate, ListCustomersParamsFilter, ListSubscriptionsParamsFilter, ListAppsParamsFilter, ListBillingProfilesParamsFilter, ListFeatureParamsFilter, ListAddonsParamsFilter, ListPlanAddonsParamsFilter, CreateCreditGrantTaxConfig, CreditGrantTaxConfig, RateCardTaxConfig, TaxConfig, OrganizationDefaultTaxCodes, InvoiceWorkflowAppsReferences, ProfileAppReferences, PlanAddon, UpdateRateCardTaxConfig, ListEventsParamsFilter, ListCustomerChargesParamsFilter, ListInvoicesParamsFilter, ListChargesParamsFilter, ResourceFilters, FieldFilters, IngestedEvent, MeterQueryResult, ChargeRealizationDetailedLineFlatFee, ChargeRealizationDetailedLineUsageBased, CurrencyCustom, FeatureCostQueryResult, MeterPagePaginatedResponse, CostBasisPagePaginatedResponse, MeterQueryFilters, FeatureMeterReference, Customer, PartyAddresses, InvoiceCustomer, UpdateBillingPartyAddresses, UpdateInvoiceCustomer, AppStripeCreateCheckoutSessionConsentCollection, SubscriptionEditAddPhase, WorkflowCollectionAlignmentAnchored, SubscriptionBase, InvoiceStatusDetails, InvoiceWorkflow, SubscriptionCancel, SubscriptionMigrate, SubscriptionAddonUpdate, TaxCode, AppCatalogItem, InvoiceLineDiscounts, UpdateBillingInvoiceWorkflow, EntitlementFeatureAccess, CustomerData, UpsertCustomerBillingDataRequest, CreditBalances, CreditTransactionPaginatedResponse, ChargeFlatFeeSystemIntent, ListCustomerEntitlementAccessResponseData, PriceGraduated, PriceVolume, UpdatePriceGraduated, UpdatePriceVolume, PricePagePaginatedResponse, CreateCreditGrantPurchase, CreditGrantPurchase, CreateChargeFlatFeeRequest, WorkflowTaxSettings, PlanAddonPagePaginatedResponse, IngestedEventPaginatedResponse, InvalidParameters, MeterQueryRequest, CustomerPagePaginatedResponse, Supplier, Party, UpdateSupplier, AppStripeCreateCheckoutSessionRequestOptions, InvoiceWorkflowSettings, TaxCodePagePaginatedResponse, AppStripe, AppSandbox, AppExternalInvoicing, AppCatalogItemPagePaginatedResponse, InstalledAppStripe, InstalledAppSandbox, InstalledAppExternalInvoicing, InvoiceDetailedLine, UpdateInvoiceWorkflowSettings, EntitlementAccessQueryResult, Feature, CreditGrant, CurrencyPagePaginatedResponse, BadRequest, InvoiceBase, CustomerStripeCreateCheckoutSessionRequest, WorkflowCollectionSettings, ChargeRealizationInvoice, EntitlementAccessQueryResponse, RateCard, InvoiceLineRateCard, ChargeUsageBasedSystemIntent, CreateChargeUsageBasedRequest, FeaturePagePaginatedResponse, UpdateInvoiceLineRateCard, CreditGrantPagePaginatedResponse, Workflow, AppPagePaginatedResponse, ProfileApps, SubscriptionItem, PlanPhase, SubscriptionEditAddItem, SubscriptionAddonRateCard, Addon, UpsertAddonRequest, InvoiceStandardLine, UpdateInvoiceStandardLine, Profile, UpsertBillingProfileRequest, ChargeRealization, SubscriptionPhase, SubscriptionCustomPlan, Plan, UpsertPlanRequest, SubscriptionAddon, AddonPagePaginatedResponse, ProfilePagePaginatedResponse, Subscription, SubscriptionCreate, SubscriptionChange, PlanPagePaginatedResponse, SubscriptionEdit, SubscriptionAddonPagePaginatedResponse, InvoiceStandard, UpdateInvoiceStandardRequest, SubscriptionPagePaginatedResponse, SubscriptionChangeResponse, SubscriptionMigrateResponse, ChargeFlatFee, ChargeUsageBased, InvoicePagePaginatedResponse, ChargePagePaginatedResponse, StringFieldFilter, MeterAggregation, MeterQueryGranularity, StringFieldFilterExact, PricePaymentTerm, BillingCurrencyCode, CreateCurrencyCode, UlidFieldFilter, DateTimeFieldFilter, WorkflowPaymentSettings, SubscriptionCreateTiming, SubscriptionEditTiming, UpdateBillingWorkflowPaymentSettings, CreateChargeCostBasis, ChargeCostBasis, InvalidParameter, RateCardEntitlement, FeatureUnitCost, ChargeRealizationDetailedLine, Currency, CustomerOrReference, WorkflowCollectionAlignment, Price, PriceUsageBased, UpdatePrice, App, BillingInstallAppResponse, FeatureOrReference, ChargeRealizationInvoiceOrReference, CreateChargeRequest, SubscriptionEditOperation, InvoiceLine, UpdateInvoiceLine, SubscriptionOrReference, Invoice, Charge, SortQueryInput, BaseErrorInput, InvoiceWorkflowInvoicingSettingsInput, WorkflowPaymentSendInvoiceSettingsInput, UpdateBillingInvoiceWorkflowInvoicingSettingsInput, UpdateBillingWorkflowPaymentSendInvoiceSettingsInput, EventInput, UnauthorizedInput, ForbiddenInput, NotFoundInput, GoneInput, ConflictInput, PayloadTooLargeInput, UnsupportedMediaTypeInput, UnprocessableContentInput, TooManyRequestsInput, InternalInput, NotImplementedInput, NotAvailableInput, AppStripeCreateCheckoutSessionCustomerUpdateInput, AppStripeCreateCheckoutSessionTaxIdCollectionInput, RateCardMeteredEntitlementInput, VoidCreditGrantRequestInput, UnitConfigInput, WorkflowInvoicingSettingsInput, EntitlementAccessQueryRequestInput, IngestedEventInput, SubscriptionBaseInput, InvoiceWorkflowInput, SubscriptionCancelInput, SubscriptionMigrateInput, UpdateBillingInvoiceWorkflowInput, CreateCreditGrantPurchaseInput, CreditGrantPurchaseInput, WorkflowTaxSettingsInput, IngestedEventPaginatedResponseInput, MeterQueryRequestInput, AppStripeCreateCheckoutSessionRequestOptionsInput, InvoiceWorkflowSettingsInput, InvoiceDetailedLineInput, UpdateInvoiceWorkflowSettingsInput, CreateCreditGrantRequestInput, CreditGrantInput, BadRequestInput, CustomerStripeCreateCheckoutSessionRequestInput, WorkflowCollectionSettingsInput, ChargeRealizationInvoiceInput, RateCardInput, InvoiceLineRateCardInput, ChargeUsageBasedSystemIntentInput, CreateChargeUsageBasedRequestInput, CreditGrantPagePaginatedResponseInput, WorkflowInput, SubscriptionItemInput, PlanPhaseInput, SubscriptionEditAddItemInput, SubscriptionAddonRateCardInput, AddonInput, CreateAddonRequestInput, UpsertAddonRequestInput, InvoiceStandardLineInput, ProfileInput, CreateBillingProfileRequestInput, UpsertBillingProfileRequestInput, ChargeRealizationInput, SubscriptionPhaseInput, SubscriptionCustomPlanInput, PlanInput, CreatePlanRequestInput, UpsertPlanRequestInput, SubscriptionAddonInput, AddonPagePaginatedResponseInput, ProfilePagePaginatedResponseInput, SubscriptionInput, SubscriptionCreateInput, SubscriptionChangeInput, PlanPagePaginatedResponseInput, SubscriptionEditInput, SubscriptionAddonPagePaginatedResponseInput, InvoiceStandardInput, UpdateInvoiceStandardRequestInput, SubscriptionPagePaginatedResponseInput, SubscriptionChangeResponseInput, SubscriptionMigrateResponseInput, ChargeFlatFeeInput, ChargeUsageBasedInput, InvoicePagePaginatedResponseInput, ChargePagePaginatedResponseInput, WorkflowPaymentSettingsInput, UpdateBillingWorkflowPaymentSettingsInput, RateCardEntitlementInput, ChargeRealizationInvoiceOrReferenceInput, CreateChargeRequestInput, SubscriptionEditOperationInput, InvoiceLineInput, SubscriptionOrReferenceInput, InvoiceInput, UpdateInvoiceRequestInput, ChargeInput, } from './models/types.js';

package/dist/index.js

@@ -5,6 +5,7 @@ export { Meters } from './sdk/meters.js';
 export { Customers } from './sdk/customers.js';
 export { Entitlements } from './sdk/entitlements.js';
 export { Subscriptions } from './sdk/subscriptions.js';
+export { Apps } from './sdk/apps.js';
 export { Billing } from './sdk/billing.js';
 export { Tax } from './sdk/tax.js';
 export { Features } from './sdk/features.js';

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v1.0.0-beta.232";
+export declare const SDK_VERSION = "v1.0.0-beta.233";

package/dist/lib/version.js

@@ -2,4 +2,4 @@
 // The committed value is a dev placeholder. The publish flow
 // (`make -C api/spec publish-aip-sdk`) stamps the real release version here
 // before `pnpm publish`, after `pnpm version` updates package.json.
-export const SDK_VERSION = 'v1.0.0-beta.232';
+export const SDK_VERSION = 'v1.0.0-beta.233';

package/dist/lib/wire.js

@@ -212,7 +212,13 @@ function walk(data, schema, dir, depth = 0) {
     if (d?.type === 'union') {
         const variant = selectVariant(record, s, dir);
         if (!variant) {
-            // No confident match: leave keys untransformed rather than guess.
+            // No variant owns this data: a discriminated union whose discriminator
+            // value the SDK does not know (a variant added server-side after
+            // generation), or a union with no object-shaped variant at all reached
+            // with object data. Both mean the schema describes nothing about these
+            // keys, so leave them untransformed rather than guess. Note this is NOT
+            // the zero-key-coverage case — a non-discriminated union with any object
+            // variant always resolves one; see selectVariant.
             return data;
         }
         return walk(data, variant, dir, depth + 1);
@@ -279,11 +285,61 @@ function selectVariant(data, schema, dir) {
         const dataKey = dir.discriminatorKey(d.discriminator);
         return variantsByDiscriminator(schema, d).get(data[dataKey]);
     }
-    // Non-discriminated union: the codegen gate guarantees at most one object
-    // variant (it fails the build for a mapped union with two or more), so the single
-    // object-shaped option is unambiguous. Other variants (scalars, arrays) reach the
-    // walk through their own data-kind branches, not here.
-    return options.find((option) => def(unwrap(option))?.type === 'object');
+    // Non-discriminated union: pick the object variant that best covers the data's
+    // keys. The codegen gate guarantees the object variants agree on every key they
+    // share (they differ only in WHICH keys they declare, e.g. a customer reference
+    // versus the full customer), so the pick can never change how a key is mapped —
+    // it only decides which keys the object branch keeps. Most keys matched
+    // therefore preserves a wider variant's extra fields, and the narrowest shape
+    // wins a tie so toWire does not materialize defaults for a field the value never
+    // carried. Other variants (scalars, arrays) reach the walk through their own
+    // data-kind branches, not here.
+    const dataKeys = Object.keys(data);
+    let best;
+    // Starting below zero means data that matches NO variant's keys still selects
+    // one — the narrowest, by the tie-break below — instead of falling through to
+    // the pass-through above. That is deliberate: the selected variant's object
+    // walk then drops the undeclared keys, exactly as the object branch does for a
+    // non-union field. Passing the keys through instead would put snake_case names
+    // into a value fromWire's return type declares to be camelCase.
+    let bestMatched = -1;
+    let bestWidth = 0;
+    for (const option of options) {
+        // A variant that is itself a union (`Invoice | InvoiceReference`, where
+        // `Invoice` is the discriminated union of its concrete types) resolves
+        // through its own selection first, so the nested union contributes the one
+        // variant its discriminator — or its own key coverage — identifies. Without
+        // this the nested union is no object and gets skipped, leaving the
+        // reference variant the only candidate and silently dropping every field
+        // of an expanded resource. A nested union that cannot resolve (reference
+        // data carries no discriminator) contributes nothing, which is what leaves
+        // the reference variant to win on its own merits. The gate verifies a
+        // nested union's variants against the outer siblings they compete with, so
+        // the agreement guarantee above covers them too. It does not verify two
+        // nested unions against each other; no union in the spec declares two
+        // union-typed variants.
+        const inner = unwrap(option);
+        const candidate = def(inner)?.type === 'union' ? selectVariant(data, inner, dir) : option;
+        const resolved = unwrap(candidate);
+        if (def(resolved)?.type !== 'object') {
+            continue;
+        }
+        const shape = shapeOf(resolved) ?? {};
+        const width = Object.keys(shape).length;
+        let matched = 0;
+        for (const key of dataKeys) {
+            if (fieldFor(shape, key) !== undefined) {
+                matched++;
+            }
+        }
+        if (matched > bestMatched ||
+            (matched === bestMatched && width < bestWidth)) {
+            best = candidate;
+            bestMatched = matched;
+            bestWidth = width;
+        }
+    }
+    return best;
 }
 // Memoized literal→variant map for a discriminated union, built once per schema.
 const variantMapCache = new WeakMap();

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

@@ -1,11 +1,27 @@
 import type { AcceptDateStrings } from '../../lib/wire.js';
-import type { App, AppCatalogItem, AppCatalogItemPagePaginatedResponse, AppPagePaginatedResponse, BillingInstallAppResponse, InstallAppRequest as InstallAppRequestBody, UpdateAppRequest as UpdateAppRequestBody } from '../types.js';
+import type { App, AppCatalogItem, AppCatalogItemPagePaginatedResponse, AppPagePaginatedResponse, BillingInstallAppResponse, InstallAppRequest as InstallAppRequestBody, ListAppsParamsFilter, SortQueryInput, UpdateAppRequest as UpdateAppRequestBody } from '../types.js';
 export interface ListAppsQuery {
     /** Determines which page of the collection to retrieve. */
     page?: {
         size?: number;
         number?: number;
     };
+    /**
+     * Sort apps returned in the response. Supported sort attributes are:
+     *
+     * - `id`
+     * - `created_at` (default)
+     *
+     * The `asc` suffix is optional as the default sort order is ascending. The `desc`
+     * suffix is used to specify a descending order.
+     */
+    sort?: SortQueryInput;
+    /**
+     * Filter apps returned in the response.
+     *
+     * To filter apps by name add the following query param: filter[name]=my-app
+     */
+    filter?: ListAppsParamsFilter;
 }
 export type ListAppsRequest = AcceptDateStrings<ListAppsQuery>;
 export type ListAppsResponse = AppPagePaginatedResponse;

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

@@ -1,11 +1,29 @@
 import type { AcceptDateStrings } from '../../lib/wire.js';
-import type { CreateBillingProfileRequestInput, Profile, ProfilePagePaginatedResponse, UpsertBillingProfileRequestInput } from '../types.js';
+import type { CreateBillingProfileRequestInput, ListBillingProfilesParamsFilter, Profile, ProfilePagePaginatedResponse, SortQueryInput, UpsertBillingProfileRequestInput } from '../types.js';
 export interface ListBillingProfilesQuery {
     /** Determines which page of the collection to retrieve. */
     page?: {
         size?: number;
         number?: number;
     };
+    /**
+     * Sort billing profiles returned in the response. Supported sort attributes are:
+     *
+     * - `id`
+     * - `name`
+     * - `created_at` (default)
+     *
+     * The `asc` suffix is optional as the default sort order is ascending. The `desc`
+     * suffix is used to specify a descending order.
+     */
+    sort?: SortQueryInput;
+    /**
+     * Filter billing profiles returned in the response.
+     *
+     * To filter billing profiles by name add the following query param:
+     * filter[name]=my-profile
+     */
+    filter?: ListBillingProfilesParamsFilter;
 }
 export type ListBillingProfilesRequest = AcceptDateStrings<ListBillingProfilesQuery>;
 export type ListBillingProfilesResponse = ProfilePagePaginatedResponse;

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

@@ -0,0 +1,54 @@
+import type { AcceptDateStrings } from '../../lib/wire.js';
+import type { ChargePagePaginatedResponse, ListChargesParamsFilter, SortQueryInput } from '../types.js';
+export interface ListChargesQuery {
+    /** Determines which page of the collection to retrieve. */
+    page?: {
+        size?: number;
+        number?: number;
+    };
+    /**
+     * Sort charges returned in the response.
+     *
+     * Supported sort attributes are:
+     *
+     * - `id`
+     * - `created_at`
+     * - `service_period.from`
+     * - `billing_period.from`
+     */
+    sort?: SortQueryInput;
+    /**
+     * Filter charges.
+     *
+     * To filter charges by customer add the following query param:
+     * `filter[customer_id][eq]=<id>` or `filter[customer_id][oeq]=<id>,<id>`.
+     *
+     * To filter charges by status add the following query param:
+     * `filter[status][oeq]=created,active`
+     *
+     * To filter charges by feature, use `filter[feature_id][oeq]=<id>,<id>` or
+     * `filter[feature_key][oeq]=<key>,<key>`.
+     *
+     * See the `service_period_from` filter field for expressing a service-period
+     * window query.
+     */
+    filter?: ListChargesParamsFilter;
+    /**
+     * Expand full objects for referenced entities.
+     *
+     * Supported values are:
+     *
+     * - `real_time_usage`: Expand the charge's real-time usage; it sets the `usage`
+     * and the `totals.realtime` fields.
+     * - `customer`: Expand the charge's customer to the complete entity.
+     * - `feature`: Expand the charge's feature to the complete entity.
+     * - `subscription`: Expand the charge's subscription to the complete entity.
+     * - `realization.invoice`: Expand each realization's invoice to the complete
+     * entity.
+     * - `realization.totals`: Expand each realization run's `totals`.
+     * - `realization.detailed_lines`: Expand each realization run's `detailed_lines`.
+     */
+    expand?: ('real_time_usage' | 'customer' | 'feature' | 'subscription' | 'realization.invoice' | 'realization.totals' | 'realization.detailed_lines')[];
+}
+export type ListChargesRequest = AcceptDateStrings<ListChargesQuery>;
+export type ListChargesResponse = ChargePagePaginatedResponse;

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

@@ -1,5 +1,5 @@
 import type { AcceptDateStrings } from '../../lib/wire.js';
-import type { AppCustomerData, AppStripeCreateCheckoutSessionResult, AppStripeCreateCustomerPortalSessionResult, Charge, ChargePagePaginatedResponse, CreateChargeRequest, CreateCreditAdjustmentRequest as CreateCreditAdjustmentRequestBody, CreateCreditGrantRequestInput, CreateCustomerRequest as CreateCustomerRequestBody, CreditAdjustment, CreditBalances, CreditGrant, CreditGrantPagePaginatedResponse, CreditTransactionPaginatedResponse, CursorPaginationQueryPage, Customer, CustomerData, CustomerPagePaginatedResponse, CustomerStripeCreateCheckoutSessionRequestInput, CustomerStripeCreateCustomerPortalSessionRequest, GetCreditBalanceParamsFilter, ListChargesParamsFilter, ListCreditGrantsParamsFilter, ListCreditTransactionsParamsFilter, ListCustomersParamsFilter, SortQueryInput, UpdateCreditGrantExternalSettlementRequest as UpdateCreditGrantExternalSettlementRequestBody, UpsertAppCustomerDataRequest, UpsertCustomerBillingDataRequest, UpsertCustomerRequest as UpsertCustomerRequestBody, VoidCreditGrantRequestInput } from '../types.js';
+import type { AppCustomerData, AppStripeCreateCheckoutSessionResult, AppStripeCreateCustomerPortalSessionResult, Charge, ChargePagePaginatedResponse, CreateChargeRequestInput, CreateCreditAdjustmentRequest as CreateCreditAdjustmentRequestBody, CreateCreditGrantRequestInput, CreateCustomerRequest as CreateCustomerRequestBody, CreditAdjustment, CreditBalances, CreditGrant, CreditGrantPagePaginatedResponse, CreditTransactionPaginatedResponse, CursorPaginationQueryPage, Customer, CustomerData, CustomerPagePaginatedResponse, CustomerStripeCreateCheckoutSessionRequestInput, CustomerStripeCreateCustomerPortalSessionRequest, GetCreditBalanceParamsFilter, ListCreditGrantsParamsFilter, ListCreditTransactionsParamsFilter, ListCustomerChargesParamsFilter, ListCustomersParamsFilter, SortQueryInput, UpdateCreditGrantExternalSettlementRequest as UpdateCreditGrantExternalSettlementRequestBody, UpsertAppCustomerDataRequest, UpsertCustomerBillingDataRequest, UpsertCustomerRequest as UpsertCustomerRequestBody, VoidCreditGrantRequestInput } from '../types.js';
 export type CreateCustomerRequest = AcceptDateStrings<CreateCustomerRequestBody>;
 export type CreateCustomerResponse = Customer;
 export type GetCustomerRequest = {
@@ -150,16 +150,30 @@ export interface ListCustomerChargesQuery {
      *
      * To filter charges by status add the following query param:
      * `filter[status][oeq]=created,active`
+     *
+     * To filter charges by feature, use `filter[feature_id][oeq]=<id>,<id>` or
+     * `filter[feature_key][oeq]=<key>,<key>`.
+     *
+     * See the `service_period_from` filter field for expressing a service-period
+     * window query.
      */
-    filter?: ListChargesParamsFilter;
+    filter?: ListCustomerChargesParamsFilter;
     /**
      * Expand full objects for referenced entities.
      *
      * Supported values are:
      *
-     * - `real_time_usage`: Expand the charge's real-time usage.
+     * - `real_time_usage`: Expand the charge's real-time usage; it sets the `usage`
+     * and the `totals.realtime` fields.
+     * - `customer`: Expand the charge's customer to the complete entity.
+     * - `feature`: Expand the charge's feature to the complete entity.
+     * - `subscription`: Expand the charge's subscription to the complete entity.
+     * - `realization.invoice`: Expand each realization's invoice to the complete
+     * entity.
+     * - `realization.totals`: Expand each realization run's `totals`.
+     * - `realization.detailed_lines`: Expand each realization run's `detailed_lines`.
      */
-    expand?: 'real_time_usage'[];
+    expand?: ('real_time_usage' | 'customer' | 'feature' | 'subscription' | 'realization.invoice' | 'realization.totals' | 'realization.detailed_lines')[];
 }
 export type ListCustomerChargesRequest = AcceptDateStrings<ListCustomerChargesQuery & {
     customerId: string;
@@ -167,6 +181,6 @@ export type ListCustomerChargesRequest = AcceptDateStrings<ListCustomerChargesQu
 export type ListCustomerChargesResponse = ChargePagePaginatedResponse;
 export type CreateCustomerChargesRequest = AcceptDateStrings<{
     customerId: string;
-    body: CreateChargeRequest;
+    body: CreateChargeRequestInput;
 }>;
 export type CreateCustomerChargesResponse = Charge;