@openmeter/client 1.0.0-beta-081c456ce358 → 1.0.0-beta-0abbaf78837c

package/README.md

@@ -422,18 +422,20 @@ they can change or be removed without notice or semver consideration.
 
 ### Internal Customers
 
-| Method                                              | HTTP                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| --------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `client.internal.customers.entitlements.create`     | `POST /openmeter/customers/{customerId}/entitlements`                         | Create an entitlement for the customer. A customer can have only one active entitlement per feature. The feature must be compatible with the entitlement type. Entitlements cannot be modified after creation, only deleted.                                                                                                                                                                                                                                                                                                                                                                    |
-| `client.internal.customers.entitlements.override`   | `PUT /openmeter/customers/{customerId}/entitlements/{entitlementId}/override` | Override an entitlement of the customer with a new one. The referenced entitlement ends and the new one starts at the same instant, so access continues without a gap. Both must belong to the same feature. Use this for upgrades and downgrades. Fails if the referenced entitlement does not exist, is deleted, or is no longer active.                                                                                                                                                                                                                                                      |
-| `client.internal.customers.entitlements.getHistory` | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/history`  | Get the balance and usage history of a metered entitlement. The queried range may span multiple usage periods. `windowed_history` groups usage into windows of the requested size and reports the balance at the start of each window. `burndown_history` lists the periods in which grants were consumed in a fixed order, together with the usage taken from each grant.                                                                                                                                                                                                                      |
-| `client.internal.customers.entitlements.get`        | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}`          | Get an entitlement of the customer by ID. For checking entitlement access, use the entitlement access endpoints instead.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| `client.internal.customers.entitlements.list`       | `GET /openmeter/customers/{customerId}/entitlements`                          | List the entitlements of the customer that are active at the time of the request. For checking entitlement access, use the entitlement access endpoints instead.                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| `client.internal.customers.entitlements.resetUsage` | `POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/reset`   | Reset the usage of a metered entitlement. The reset starts a new usage period: usage is zeroed and grants roll over according to their rollover settings. Usage is reset automatically at the end of each usage period. Use this operation to reset it earlier, for example to align the entitlement with the customer's billing period. The usage period anchor can be moved at the same time.                                                                                                                                                                                                 |
-| `client.internal.customers.entitlements.delete`     | `DELETE /openmeter/customers/{customerId}/entitlements/{entitlementId}`       | Deletes the entitlement and revokes access to its feature. A customer can hold only one active entitlement per feature, so migrating a feature requires deleting the previous entitlement first. Deletion sets the `deleted_at` timestamp instead of removing history. Access and status queries for earlier points in time still treat the entitlement as active, so access changes are never retroactive.                                                                                                                                                                                     |
-| `client.internal.customers.credits.grants.void`     | `POST /openmeter/customers/{customerId}/credits/grants/{creditGrantId}/void`  | Void a credit grant, forfeiting the remaining unused balance. Voiding is a forward-looking, irreversible operation. Credits already consumed by usage remain unaffected — only the remaining balance is forfeited. The grant reads as `voided` status afterwards. Payment state is not adjusted when `payment_adjustment` is `none`, so invoice-backed or externally collected payments may still collect the original amount. Only `active` grants can be voided; voiding a pending, expired, or fully consumed grant returns a conflict. Retrying a successful void is an idempotent success. |
-| `client.internal.customers.charges.list`            | `GET /openmeter/customers/{customerId}/charges`                               | List customer charges. Returns the customer's charges that are represented as either flat fee or usage-based charges.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `client.internal.customers.charges.create`          | `POST /openmeter/customers/{customerId}/charges`                              | Create customer charge.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Method                                                 | HTTP                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| ------------------------------------------------------ | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `client.internal.customers.entitlements.create`        | `POST /openmeter/customers/{customerId}/entitlements`                         | Create an entitlement for the customer. A customer can have only one active entitlement per feature. The feature must be compatible with the entitlement type. Entitlements cannot be modified after creation, only deleted.                                                                                                                                                                                                                                                                                                                                                                    |
+| `client.internal.customers.entitlements.override`      | `PUT /openmeter/customers/{customerId}/entitlements/{entitlementId}/override` | Override an entitlement of the customer with a new one. The referenced entitlement ends and the new one starts at the same instant, so access continues without a gap. Both must belong to the same feature. Use this for upgrades and downgrades. Fails if the referenced entitlement does not exist, is deleted, or is no longer active.                                                                                                                                                                                                                                                      |
+| `client.internal.customers.entitlements.getHistory`    | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/history`  | Get the balance and usage history of a metered entitlement. The queried range may span multiple usage periods. `windowed_history` groups usage into windows of the requested size and reports the balance at the start of each window. `burndown_history` lists the periods in which grants were consumed in a fixed order, together with the usage taken from each grant.                                                                                                                                                                                                                      |
+| `client.internal.customers.entitlements.get`           | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}`          | Get an entitlement of the customer by ID. For checking entitlement access, use the entitlement access endpoints instead.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `client.internal.customers.entitlements.list`          | `GET /openmeter/customers/{customerId}/entitlements`                          | List the entitlements of the customer that are active at the time of the request. For checking entitlement access, use the entitlement access endpoints instead.                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `client.internal.customers.entitlements.resetUsage`    | `POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/reset`   | Reset the usage of a metered entitlement. The reset starts a new usage period: usage is zeroed and grants roll over according to their rollover settings. Usage is reset automatically at the end of each usage period. Use this operation to reset it earlier, for example to align the entitlement with the customer's billing period. The usage period anchor can be moved at the same time.                                                                                                                                                                                                 |
+| `client.internal.customers.entitlements.delete`        | `DELETE /openmeter/customers/{customerId}/entitlements/{entitlementId}`       | Deletes the entitlement and revokes access to its feature. A customer can hold only one active entitlement per feature, so migrating a feature requires deleting the previous entitlement first. Deletion sets the `deleted_at` timestamp instead of removing history. Access and status queries for earlier points in time still treat the entitlement as active, so access changes are never retroactive.                                                                                                                                                                                     |
+| `client.internal.customers.entitlements.grants.create` | `POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants`  | Issue a grant for a metered entitlement of the customer. Boolean and static entitlements cannot have grants, so the request is rejected for them. Grants are immutable. The amount is added to the balance from `effective_at`, which cannot be earlier than the start of the current usage period.                                                                                                                                                                                                                                                                                             |
+| `client.internal.customers.entitlements.grants.list`   | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants`   | List the grants issued for an entitlement of the customer. Grants only exist for metered entitlements, so the list is empty for boolean and static entitlements. Deleted grants are excluded unless `include_deleted` is set. Voided and expired grants are always included, as they are part of the balance history.                                                                                                                                                                                                                                                                           |
+| `client.internal.customers.credits.grants.void`        | `POST /openmeter/customers/{customerId}/credits/grants/{creditGrantId}/void`  | Void a credit grant, forfeiting the remaining unused balance. Voiding is a forward-looking, irreversible operation. Credits already consumed by usage remain unaffected — only the remaining balance is forfeited. The grant reads as `voided` status afterwards. Payment state is not adjusted when `payment_adjustment` is `none`, so invoice-backed or externally collected payments may still collect the original amount. Only `active` grants can be voided; voiding a pending, expired, or fully consumed grant returns a conflict. Retrying a successful void is an idempotent success. |
+| `client.internal.customers.charges.list`               | `GET /openmeter/customers/{customerId}/charges`                               | List customer charges. Returns the customer's charges that are represented as either flat fee or usage-based charges.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `client.internal.customers.charges.create`             | `POST /openmeter/customers/{customerId}/charges`                              | Create customer charge.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 ### Internal Entitlements
 

package/dist/funcs/customers.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from '../core.js';
 import { type Result, type RequestOptions } from '../lib/types.js';
-import type { CreateCustomerRequest, CreateCustomerResponse, GetCustomerRequest, GetCustomerResponse, ListCustomersRequest, ListCustomersResponse, UpsertCustomerRequest, UpsertCustomerResponse, DeleteCustomerRequest, DeleteCustomerResponse, GetCustomerBillingRequest, GetCustomerBillingResponse, UpdateCustomerBillingRequest, UpdateCustomerBillingResponse, UpdateCustomerBillingAppDataRequest, UpdateCustomerBillingAppDataResponse, CreateCustomerStripeCheckoutSessionRequest, CreateCustomerStripeCheckoutSessionResponse, CreateCustomerStripePortalSessionRequest, CreateCustomerStripePortalSessionResponse, CreateCustomerEntitlementRequest, CreateCustomerEntitlementResponse, OverrideCustomerEntitlementRequest, OverrideCustomerEntitlementResponse, GetCustomerEntitlementHistoryRequest, GetCustomerEntitlementHistoryResponse, GetCustomerEntitlementRequest, GetCustomerEntitlementResponse, ListCustomerEntitlementsRequest, ListCustomerEntitlementsResponse, ResetCustomerEntitlementUsageRequest, ResetCustomerEntitlementUsageResponse, DeleteCustomerEntitlementRequest, DeleteCustomerEntitlementResponse, CreateCreditGrantRequest, CreateCreditGrantResponse, GetCreditGrantRequest, GetCreditGrantResponse, ListCreditGrantsRequest, ListCreditGrantsResponse, GetCustomerCreditBalanceRequest, GetCustomerCreditBalanceResponse, CreateCreditAdjustmentRequest, CreateCreditAdjustmentResponse, VoidCreditGrantRequest, VoidCreditGrantResponse, UpdateCreditGrantExternalSettlementRequest, UpdateCreditGrantExternalSettlementResponse, ListCreditTransactionsRequest, ListCreditTransactionsResponse, ListCustomerChargesRequest, ListCustomerChargesResponse, CreateCustomerChargesRequest, CreateCustomerChargesResponse } from '../models/operations/customers.js';
+import type { CreateCustomerRequest, CreateCustomerResponse, GetCustomerRequest, GetCustomerResponse, ListCustomersRequest, ListCustomersResponse, UpsertCustomerRequest, UpsertCustomerResponse, DeleteCustomerRequest, DeleteCustomerResponse, GetCustomerBillingRequest, GetCustomerBillingResponse, UpdateCustomerBillingRequest, UpdateCustomerBillingResponse, UpdateCustomerBillingAppDataRequest, UpdateCustomerBillingAppDataResponse, CreateCustomerStripeCheckoutSessionRequest, CreateCustomerStripeCheckoutSessionResponse, CreateCustomerStripePortalSessionRequest, CreateCustomerStripePortalSessionResponse, CreateCustomerEntitlementRequest, CreateCustomerEntitlementResponse, OverrideCustomerEntitlementRequest, OverrideCustomerEntitlementResponse, GetCustomerEntitlementHistoryRequest, GetCustomerEntitlementHistoryResponse, GetCustomerEntitlementRequest, GetCustomerEntitlementResponse, ListCustomerEntitlementsRequest, ListCustomerEntitlementsResponse, ResetCustomerEntitlementUsageRequest, ResetCustomerEntitlementUsageResponse, DeleteCustomerEntitlementRequest, DeleteCustomerEntitlementResponse, CreateCustomerEntitlementGrantRequest, CreateCustomerEntitlementGrantResponse, ListCustomerEntitlementGrantsRequest, ListCustomerEntitlementGrantsResponse, CreateCreditGrantRequest, CreateCreditGrantResponse, GetCreditGrantRequest, GetCreditGrantResponse, ListCreditGrantsRequest, ListCreditGrantsResponse, GetCustomerCreditBalanceRequest, GetCustomerCreditBalanceResponse, CreateCreditAdjustmentRequest, CreateCreditAdjustmentResponse, VoidCreditGrantRequest, VoidCreditGrantResponse, UpdateCreditGrantExternalSettlementRequest, UpdateCreditGrantExternalSettlementResponse, ListCreditTransactionsRequest, ListCreditTransactionsResponse, ListCustomerChargesRequest, ListCustomerChargesResponse, CreateCustomerChargesRequest, CreateCustomerChargesResponse } from '../models/operations/customers.js';
 /**
  * Create customer
  *
@@ -167,6 +167,30 @@ export declare function resetCustomerEntitlementUsage(client: Client, req: Reset
  * DELETE /openmeter/customers/{customerId}/entitlements/{entitlementId}
  */
 export declare function deleteCustomerEntitlement(client: Client, req: DeleteCustomerEntitlementRequest, options?: RequestOptions): Promise<Result<DeleteCustomerEntitlementResponse>>;
+/**
+ * Create customer entitlement grant
+ *
+ * Issue a grant for a metered entitlement of the customer. Boolean and static
+ * entitlements cannot have grants, so the request is rejected for them.
+ *
+ * Grants are immutable. The amount is added to the balance from `effective_at`,
+ * which cannot be earlier than the start of the current usage period.
+ *
+ * POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+ */
+export declare function createCustomerEntitlementGrant(client: Client, req: CreateCustomerEntitlementGrantRequest, options?: RequestOptions): Promise<Result<CreateCustomerEntitlementGrantResponse>>;
+/**
+ * List customer entitlement grants
+ *
+ * List the grants issued for an entitlement of the customer. Grants only exist for
+ * metered entitlements, so the list is empty for boolean and static entitlements.
+ *
+ * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+ * grants are always included, as they are part of the balance history.
+ *
+ * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+ */
+export declare function listCustomerEntitlementGrants(client: Client, req: ListCustomerEntitlementGrantsRequest, options?: RequestOptions): Promise<Result<ListCustomerEntitlementGrantsResponse>>;
 /**
  * Create a new credit grant
  *

package/dist/funcs/customers.js

@@ -675,6 +675,112 @@ export function deleteCustomerEntitlement(client, req, options) {
         await http(client).delete(path, options);
     });
 }
+/**
+ * Create customer entitlement grant
+ *
+ * Issue a grant for a metered entitlement of the customer. Boolean and static
+ * entitlements cannot have grants, so the request is rejected for them.
+ *
+ * Grants are immutable. The amount is added to the balance from `effective_at`,
+ * which cannot be earlier than the start of the current usage period.
+ *
+ * POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+ */
+export function createCustomerEntitlementGrant(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            customerId: req.customerId,
+            entitlementId: req.entitlementId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.createCustomerEntitlementGrantPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.createCustomerEntitlementGrantPathParamsWire, pathParams);
+        }
+        const path = `openmeter/customers/${(() => {
+            if (pathParams.customerId === undefined) {
+                throw new Error('missing path parameter: customerId');
+            }
+            return encodeURIComponent(String(pathParams.customerId));
+        })()}/entitlements/${(() => {
+            if (pathParams.entitlementId === undefined) {
+                throw new Error('missing path parameter: entitlementId');
+            }
+            return encodeURIComponent(String(pathParams.entitlementId));
+        })()}/grants`;
+        const body = toWire(req.body, schemas.createCustomerEntitlementGrantBody);
+        if (client._options.validate) {
+            assertValid(schemas.createCustomerEntitlementGrantBodyWire, body);
+        }
+        return http(client)
+            .post(path, { ...options, json: body })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.createCustomerEntitlementGrantResponseWire, data);
+            }
+            return fromWire(data, schemas.createCustomerEntitlementGrantResponse);
+        });
+    });
+}
+/**
+ * List customer entitlement grants
+ *
+ * List the grants issued for an entitlement of the customer. Grants only exist for
+ * metered entitlements, so the list is empty for boolean and static entitlements.
+ *
+ * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+ * grants are always included, as they are part of the balance history.
+ *
+ * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+ */
+export function listCustomerEntitlementGrants(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            customerId: req.customerId,
+            entitlementId: req.entitlementId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.listCustomerEntitlementGrantsPathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.listCustomerEntitlementGrantsPathParamsWire, pathParams);
+        }
+        const path = `openmeter/customers/${(() => {
+            if (pathParams.customerId === undefined) {
+                throw new Error('missing path parameter: customerId');
+            }
+            return encodeURIComponent(String(pathParams.customerId));
+        })()}/entitlements/${(() => {
+            if (pathParams.entitlementId === undefined) {
+                throw new Error('missing path parameter: entitlementId');
+            }
+            return encodeURIComponent(String(pathParams.entitlementId));
+        })()}/grants`;
+        if (client._options.validate && req.sort !== undefined) {
+            assertValid(schemas.listCustomerEntitlementGrantsQueryParams.shape.sort, req.sort);
+        }
+        const query = toWire({
+            page: req.page,
+            sort: encodeSort(req.sort, toSnakeCase),
+            includeDeleted: req.includeDeleted,
+        }, schemas.listCustomerEntitlementGrantsQueryParams);
+        if (client._options.validate) {
+            assertValid(schemas.listCustomerEntitlementGrantsQueryParamsWire, query);
+        }
+        const searchParams = toURLSearchParams(query);
+        return http(client)
+            .get(path, { ...options, searchParams })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.listCustomerEntitlementGrantsResponseWire, data);
+            }
+            return fromWire(data, schemas.listCustomerEntitlementGrantsResponse);
+        });
+    });
+}
 /**
  * Create a new credit grant
  *

package/dist/index.d.ts

@@ -43,4 +43,4 @@ export type * from './models/operations/planAddons.js';
 export type * from './models/operations/defaults.js';
 export type * from './models/operations/entitlementAccess.js';
 export type * from './models/operations/notifications.js';
-export type { Labels, CursorPaginationQueryPage, SortQuery, IngestedEventValidationError, CursorMetaPage, BaseError, PageMeta, QueryFilterString, AppStripeCheckoutSessionCustomTextParams, AppStripeCreateCustomerPortalSessionOptions, CreateLabels, CreateVersionFilter, VersionFilter, 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, EntitlementIssueAfterReset, EntitlementBurndownBalance, EntitlementBurndownGrantBalances, 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, FeatureReference, EntitlementGrantUsage, CreateChargeCostBasisPinned, CreateResourceReference, ChargeCostBasisPinned, TaxCodeReference, CreditGrantInvoiceReference, CurrencyCustomReference, SubscriptionCostBasisPin, SubscriptionReference, AppReference, ChargeRealizationInvoiceReference, AddonReference, ChargeReference, UpdateResourceReference, BillingCustomerReference, ChargeFeature, Event, MeterQueryRow, AppStripeCreateCustomerPortalSessionResult, ClosedPeriod, ChargeResolvedCostBasis, 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, SubscriptionPlanReference, UpsertPlanAddonRequest, ResourceWithKey, Meter, PaginatedMeta, QueryFilterStringMapItem, CustomerKeyReference, CustomerUsageAttribution, UpdateCustomerUsageAttribution, Address, UpdateAddress, AppStripeCreateCheckoutSessionCustomerUpdate, AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement, AppStripeCreateCheckoutSessionTaxIdCollection, AppStripeCreateCheckoutSessionResult, CustomerStripeCreateCustomerPortalSessionRequest, RecurringPeriodInput, RecurringPeriod, RateCardMeteredEntitlement, SubscriptionPhaseCreate, SubscriptionEditStretchPhase, GetCreditBalanceParamsFilter, ListPlansParamsFilter, CreateCreditGrantPlanFilter, CreditGrantPlanFilter, ListCreditGrantsParamsFilter, ValidationIssue, SubscriptionProRatingConfig, RateCardProrationConfiguration, UnitConfig, PartyTaxIdentity, UpdateBillingPartyTaxIdentity, InvoiceAvailableActions, ChargeRealizationPayment, SubscriptionEditRemovePhase, TaxCodeAppMapping, AppCapability, UpdateAppStripeRequest, UpdateAppSandboxRequest, UpdateAppExternalInvoicingRequest, WorkflowInvoicingSettings, InvoiceLineAmountDiscount, InvoiceLineUsageDiscount, InvoiceLineBaseDiscount, ListCurrenciesParamsFilter, EntitlementAccessQueryRequest, EntitlementFeatureAccessReason, EntitlementAccessQueryError, NotificationChannel, AppCustomerData, UpsertAppCustomerDataRequest, CreditAdjustment, ListCreditTransactionsParamsFilter, CurrencyAmount, EntitlementAccessResult, PriceTier, ChargeTotals, FeatureLlmUnitCost, UpdatePriceTier, LlmCostPrice, LlmCostOverrideCreate, ListCustomersParamsFilter, ListCustomerEntitlementsParamsFilter, ListEntitlementsParamsFilter, ListSubscriptionsParamsFilter, ListAppsParamsFilter, ListBillingProfilesParamsFilter, ListFeatureParamsFilter, ListAddonsParamsFilter, ListPlanAddonsParamsFilter, CreateTaxCodeConfig, TaxCodeConfig, TaxConfig, OrganizationDefaultTaxCodes, CreditBalance, CreditTransaction, InvoiceWorkflowAppsReferences, ProfileAppReferences, PlanAddon, UpdateTaxCodeConfig, ListEventsParamsFilter, ListCustomerChargesParamsFilter, ListInvoicesParamsFilter, ListChargesParamsFilter, ListNotificationChannelsParamsFilter, ResourceFilters, FieldFilters, IngestedEvent, MeterQueryResult, EntitlementHistoryWindow, EntitlementBurndownSegment, ChargeRealizationDetailedLineFlatFee, ChargeRealizationDetailedLineUsageBased, CurrencyCustom, FeatureCostQueryResult, MeterPagePaginatedResponse, CostBasisPagePaginatedResponse, MeterQueryFilters, FeatureMeterReference, Customer, PartyAddresses, InvoiceCustomer, UpdateBillingPartyAddresses, UpdateInvoiceCustomer, AppStripeCreateCheckoutSessionConsentCollection, EntitlementGrantCreateRequest, CreateEntitlementStaticRequest, CreateEntitlementBooleanRequest, EntitlementMetered, EntitlementStatic, EntitlementBoolean, WorkflowCollectionAlignmentAnchored, SubscriptionEditAddPhase, CreateCreditGrantFilters, CreditGrantFilters, SubscriptionBase, InvoiceStatusDetails, InvoiceWorkflow, SubscriptionCancel, SubscriptionMigrate, SubscriptionAddonUpdate, TaxCode, AppCatalogItem, InvoiceLineDiscounts, UpdateBillingInvoiceWorkflow, EntitlementFeatureAccess, NotificationChannelPagePaginatedResponse, CustomerData, UpsertCustomerBillingDataRequest, ChargeFlatFeeSystemIntent, ListCustomerEntitlementAccessResponseData, PriceGraduated, PriceVolume, UpdatePriceGraduated, UpdatePriceVolume, PricePagePaginatedResponse, CreateCreditGrantPurchase, CreditGrantPurchase, CreateChargeFlatFeeRequest, WorkflowTaxSettings, CreditBalances, CreditTransactionPaginatedResponse, PlanAddonPagePaginatedResponse, IngestedEventPaginatedResponse, EntitlementHistory, InvalidParameters, MeterQueryRequest, CustomerPagePaginatedResponse, Supplier, Party, UpdateSupplier, AppStripeCreateCheckoutSessionRequestOptions, CreateEntitlementMeteredRequest, InvoiceWorkflowSettings, TaxCodePagePaginatedResponse, AppStripe, AppSandbox, AppExternalInvoicing, AppCatalogItemPagePaginatedResponse, InstalledAppStripe, InstalledAppSandbox, InstalledAppExternalInvoicing, InvoiceDetailedLine, UpdateInvoiceWorkflowSettings, EntitlementAccessQueryResult, Feature, CreditGrant, CurrencyPagePaginatedResponse, BadRequest, InvoiceBase, CustomerStripeCreateCheckoutSessionRequest, EntitlementPagePaginatedResponse, 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, EntitlementHistoryWindowSize, StringFieldFilterExact, PricePaymentTerm, BooleanFieldFilter, BillingCurrencyCode, CreateCurrencyCode, UlidFieldFilter, DateTimeFieldFilter, EntitlementMeasureUsageFrom, WorkflowPaymentSettings, SubscriptionCreateTiming, SubscriptionEditTiming, UpdateBillingWorkflowPaymentSettings, CreateChargeCostBasis, ChargeCostBasis, InvalidParameter, RateCardEntitlement, FeatureUnitCost, ChargeRealizationDetailedLine, Currency, CustomerOrReference, Entitlement, WorkflowCollectionAlignment, Price, PriceUsageBased, UpdatePrice, CreateEntitlementRequest, App, BillingInstallAppResponse, FeatureOrReference, ChargeRealizationInvoiceOrReference, CreateChargeRequest, SubscriptionEditOperation, InvoiceLine, UpdateInvoiceLine, SubscriptionOrReference, Invoice, Charge, SortQueryInput, BaseErrorInput, InvoiceWorkflowInvoicingSettingsInput, WorkflowPaymentSendInvoiceSettingsInput, UpdateBillingInvoiceWorkflowInvoicingSettingsInput, UpdateBillingWorkflowPaymentSendInvoiceSettingsInput, EntitlementIssueAfterResetInput, EventInput, ResetCustomerEntitlementUsageRequestInput, UnauthorizedInput, ForbiddenInput, NotFoundInput, GoneInput, ConflictInput, PayloadTooLargeInput, UnsupportedMediaTypeInput, UnprocessableContentInput, TooManyRequestsInput, InternalInput, NotImplementedInput, NotAvailableInput, AppStripeCreateCheckoutSessionCustomerUpdateInput, AppStripeCreateCheckoutSessionTaxIdCollectionInput, RateCardMeteredEntitlementInput, VoidCreditGrantRequestInput, UnitConfigInput, WorkflowInvoicingSettingsInput, EntitlementAccessQueryRequestInput, NotificationChannelInput, CreateNotificationChannelRequestInput, UpdateNotificationChannelRequestInput, IngestedEventInput, EntitlementMeteredInput, SubscriptionBaseInput, InvoiceWorkflowInput, SubscriptionCancelInput, SubscriptionMigrateInput, UpdateBillingInvoiceWorkflowInput, NotificationChannelPagePaginatedResponseInput, CreateCreditGrantPurchaseInput, CreditGrantPurchaseInput, WorkflowTaxSettingsInput, IngestedEventPaginatedResponseInput, MeterQueryRequestInput, AppStripeCreateCheckoutSessionRequestOptionsInput, CreateEntitlementMeteredRequestInput, InvoiceWorkflowSettingsInput, InvoiceDetailedLineInput, UpdateInvoiceWorkflowSettingsInput, CreateCreditGrantRequestInput, CreditGrantInput, BadRequestInput, CustomerStripeCreateCheckoutSessionRequestInput, EntitlementPagePaginatedResponseInput, 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, EntitlementInput, CreateEntitlementRequestInput, ChargeRealizationInvoiceOrReferenceInput, CreateChargeRequestInput, SubscriptionEditOperationInput, InvoiceLineInput, SubscriptionOrReferenceInput, InvoiceInput, UpdateInvoiceRequestInput, ChargeInput, } from './models/types.js';
+export type { Labels, CursorPaginationQueryPage, SortQuery, IngestedEventValidationError, CursorMetaPage, BaseError, PageMeta, QueryFilterString, AppStripeCheckoutSessionCustomTextParams, AppStripeCreateCustomerPortalSessionOptions, CreateLabels, CreateVersionFilter, VersionFilter, 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, EntitlementIssueAfterReset, EntitlementBurndownBalance, EntitlementBurndownGrantBalances, 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, FeatureReference, EntitlementGrantUsage, CreateChargeCostBasisPinned, CreateResourceReference, ChargeCostBasisPinned, TaxCodeReference, CreditGrantInvoiceReference, CurrencyCustomReference, SubscriptionCostBasisPin, SubscriptionReference, AppReference, ChargeRealizationInvoiceReference, AddonReference, ChargeReference, UpdateResourceReference, BillingCustomerReference, ChargeFeature, Event, MeterQueryRow, AppStripeCreateCustomerPortalSessionResult, ClosedPeriod, ChargeResolvedCostBasis, 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, SubscriptionPlanReference, UpsertPlanAddonRequest, ResourceWithKey, Meter, PaginatedMeta, QueryFilterStringMapItem, CustomerKeyReference, CustomerUsageAttribution, UpdateCustomerUsageAttribution, Address, UpdateAddress, AppStripeCreateCheckoutSessionCustomerUpdate, AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement, AppStripeCreateCheckoutSessionTaxIdCollection, AppStripeCreateCheckoutSessionResult, CustomerStripeCreateCustomerPortalSessionRequest, RecurringPeriodInput, RecurringPeriod, RateCardMeteredEntitlement, SubscriptionPhaseCreate, SubscriptionEditStretchPhase, GetCreditBalanceParamsFilter, ListPlansParamsFilter, CreateCreditGrantPlanFilter, CreditGrantPlanFilter, ListCreditGrantsParamsFilter, ValidationIssue, SubscriptionProRatingConfig, RateCardProrationConfiguration, UnitConfig, PartyTaxIdentity, UpdateBillingPartyTaxIdentity, InvoiceAvailableActions, ChargeRealizationPayment, SubscriptionEditRemovePhase, TaxCodeAppMapping, AppCapability, UpdateAppStripeRequest, UpdateAppSandboxRequest, UpdateAppExternalInvoicingRequest, WorkflowInvoicingSettings, InvoiceLineAmountDiscount, InvoiceLineUsageDiscount, InvoiceLineBaseDiscount, ListCurrenciesParamsFilter, EntitlementAccessQueryRequest, EntitlementFeatureAccessReason, EntitlementAccessQueryError, NotificationChannel, AppCustomerData, UpsertAppCustomerDataRequest, CreditAdjustment, ListCreditTransactionsParamsFilter, CurrencyAmount, EntitlementAccessResult, PriceTier, ChargeTotals, FeatureLlmUnitCost, UpdatePriceTier, LlmCostPrice, LlmCostOverrideCreate, ListCustomersParamsFilter, ListCustomerEntitlementsParamsFilter, ListEntitlementsParamsFilter, ListSubscriptionsParamsFilter, ListAppsParamsFilter, ListBillingProfilesParamsFilter, ListFeatureParamsFilter, ListAddonsParamsFilter, ListPlanAddonsParamsFilter, CreateTaxCodeConfig, TaxCodeConfig, TaxConfig, OrganizationDefaultTaxCodes, CreditBalance, CreditTransaction, InvoiceWorkflowAppsReferences, ProfileAppReferences, PlanAddon, UpdateTaxCodeConfig, ListEventsParamsFilter, ListCustomerChargesParamsFilter, ListInvoicesParamsFilter, ListChargesParamsFilter, ListNotificationChannelsParamsFilter, ResourceFilters, FieldFilters, IngestedEvent, MeterQueryResult, EntitlementHistoryWindow, EntitlementBurndownSegment, ChargeRealizationDetailedLineFlatFee, ChargeRealizationDetailedLineUsageBased, CurrencyCustom, FeatureCostQueryResult, MeterPagePaginatedResponse, CostBasisPagePaginatedResponse, MeterQueryFilters, FeatureMeterReference, Customer, PartyAddresses, InvoiceCustomer, UpdateBillingPartyAddresses, UpdateInvoiceCustomer, AppStripeCreateCheckoutSessionConsentCollection, EntitlementGrantCreateRequest, CreateEntitlementStaticRequest, CreateEntitlementBooleanRequest, EntitlementMetered, EntitlementStatic, EntitlementBoolean, EntitlementGrant, WorkflowCollectionAlignmentAnchored, SubscriptionEditAddPhase, CreateCreditGrantFilters, CreditGrantFilters, SubscriptionBase, InvoiceStatusDetails, InvoiceWorkflow, SubscriptionCancel, SubscriptionMigrate, SubscriptionAddonUpdate, TaxCode, AppCatalogItem, InvoiceLineDiscounts, UpdateBillingInvoiceWorkflow, EntitlementFeatureAccess, NotificationChannelPagePaginatedResponse, CustomerData, UpsertCustomerBillingDataRequest, ChargeFlatFeeSystemIntent, ListCustomerEntitlementAccessResponseData, PriceGraduated, PriceVolume, UpdatePriceGraduated, UpdatePriceVolume, PricePagePaginatedResponse, CreateCreditGrantPurchase, CreditGrantPurchase, CreateChargeFlatFeeRequest, WorkflowTaxSettings, CreditBalances, CreditTransactionPaginatedResponse, PlanAddonPagePaginatedResponse, IngestedEventPaginatedResponse, EntitlementHistory, InvalidParameters, MeterQueryRequest, CustomerPagePaginatedResponse, Supplier, Party, UpdateSupplier, AppStripeCreateCheckoutSessionRequestOptions, CreateEntitlementMeteredRequest, EntitlementGrantPagePaginatedResponse, InvoiceWorkflowSettings, TaxCodePagePaginatedResponse, AppStripe, AppSandbox, AppExternalInvoicing, AppCatalogItemPagePaginatedResponse, InstalledAppStripe, InstalledAppSandbox, InstalledAppExternalInvoicing, InvoiceDetailedLine, UpdateInvoiceWorkflowSettings, EntitlementAccessQueryResult, Feature, CreditGrant, CurrencyPagePaginatedResponse, BadRequest, InvoiceBase, CustomerStripeCreateCheckoutSessionRequest, EntitlementPagePaginatedResponse, 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, EntitlementHistoryWindowSize, StringFieldFilterExact, PricePaymentTerm, BooleanFieldFilter, BillingCurrencyCode, CreateCurrencyCode, UlidFieldFilter, DateTimeFieldFilter, EntitlementMeasureUsageFrom, WorkflowPaymentSettings, SubscriptionCreateTiming, SubscriptionEditTiming, UpdateBillingWorkflowPaymentSettings, CreateChargeCostBasis, ChargeCostBasis, InvalidParameter, RateCardEntitlement, FeatureUnitCost, ChargeRealizationDetailedLine, Currency, CustomerOrReference, Entitlement, WorkflowCollectionAlignment, Price, PriceUsageBased, UpdatePrice, CreateEntitlementRequest, App, BillingInstallAppResponse, FeatureOrReference, ChargeRealizationInvoiceOrReference, CreateChargeRequest, SubscriptionEditOperation, InvoiceLine, UpdateInvoiceLine, SubscriptionOrReference, Invoice, Charge, SortQueryInput, BaseErrorInput, InvoiceWorkflowInvoicingSettingsInput, WorkflowPaymentSendInvoiceSettingsInput, UpdateBillingInvoiceWorkflowInvoicingSettingsInput, UpdateBillingWorkflowPaymentSendInvoiceSettingsInput, EntitlementIssueAfterResetInput, EventInput, ResetCustomerEntitlementUsageRequestInput, UnauthorizedInput, ForbiddenInput, NotFoundInput, GoneInput, ConflictInput, PayloadTooLargeInput, UnsupportedMediaTypeInput, UnprocessableContentInput, TooManyRequestsInput, InternalInput, NotImplementedInput, NotAvailableInput, AppStripeCreateCheckoutSessionCustomerUpdateInput, AppStripeCreateCheckoutSessionTaxIdCollectionInput, RateCardMeteredEntitlementInput, VoidCreditGrantRequestInput, UnitConfigInput, WorkflowInvoicingSettingsInput, EntitlementAccessQueryRequestInput, NotificationChannelInput, CreateNotificationChannelRequestInput, UpdateNotificationChannelRequestInput, IngestedEventInput, EntitlementMeteredInput, SubscriptionBaseInput, InvoiceWorkflowInput, SubscriptionCancelInput, SubscriptionMigrateInput, UpdateBillingInvoiceWorkflowInput, NotificationChannelPagePaginatedResponseInput, CreateCreditGrantPurchaseInput, CreditGrantPurchaseInput, WorkflowTaxSettingsInput, IngestedEventPaginatedResponseInput, MeterQueryRequestInput, AppStripeCreateCheckoutSessionRequestOptionsInput, CreateEntitlementMeteredRequestInput, InvoiceWorkflowSettingsInput, InvoiceDetailedLineInput, UpdateInvoiceWorkflowSettingsInput, CreateCreditGrantRequestInput, CreditGrantInput, BadRequestInput, CustomerStripeCreateCheckoutSessionRequestInput, EntitlementPagePaginatedResponseInput, 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, EntitlementInput, CreateEntitlementRequestInput, ChargeRealizationInvoiceOrReferenceInput, CreateChargeRequestInput, SubscriptionEditOperationInput, InvoiceLineInput, SubscriptionOrReferenceInput, InvoiceInput, UpdateInvoiceRequestInput, ChargeInput, } from './models/types.js';

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.0-beta-081c456ce358";
+export declare const SDK_VERSION = "1.0.0-beta-0abbaf78837c";

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 = '1.0.0-beta-081c456ce358';
+export const SDK_VERSION = '1.0.0-beta-0abbaf78837c';

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, CreateChargeRequestInput, CreateCreditAdjustmentRequest as CreateCreditAdjustmentRequestBody, CreateCreditGrantRequestInput, CreateCustomerRequest as CreateCustomerRequestBody, CreateEntitlementRequestInput, CreditAdjustment, CreditBalances, CreditGrant, CreditGrantPagePaginatedResponse, CreditTransactionPaginatedResponse, CursorPaginationQueryPage, Customer, CustomerData, CustomerPagePaginatedResponse, CustomerStripeCreateCheckoutSessionRequestInput, CustomerStripeCreateCustomerPortalSessionRequest, Entitlement, EntitlementHistory, EntitlementHistoryWindowSize, EntitlementPagePaginatedResponse, GetCreditBalanceParamsFilter, ListCreditGrantsParamsFilter, ListCreditTransactionsParamsFilter, ListCustomerChargesParamsFilter, ListCustomerEntitlementsParamsFilter, ListCustomersParamsFilter, ResetCustomerEntitlementUsageRequestInput, 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, CreateEntitlementRequestInput, CreditAdjustment, CreditBalances, CreditGrant, CreditGrantPagePaginatedResponse, CreditTransactionPaginatedResponse, CursorPaginationQueryPage, Customer, CustomerData, CustomerPagePaginatedResponse, CustomerStripeCreateCheckoutSessionRequestInput, CustomerStripeCreateCustomerPortalSessionRequest, Entitlement, EntitlementGrant, EntitlementGrantCreateRequest, EntitlementGrantPagePaginatedResponse, EntitlementHistory, EntitlementHistoryWindowSize, EntitlementPagePaginatedResponse, GetCreditBalanceParamsFilter, ListCreditGrantsParamsFilter, ListCreditTransactionsParamsFilter, ListCustomerChargesParamsFilter, ListCustomerEntitlementsParamsFilter, ListCustomersParamsFilter, ResetCustomerEntitlementUsageRequestInput, 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 = {
@@ -141,6 +141,38 @@ export type DeleteCustomerEntitlementRequest = {
     entitlementId: string;
 };
 export type DeleteCustomerEntitlementResponse = void;
+export type CreateCustomerEntitlementGrantRequest = AcceptDateStrings<{
+    customerId: string;
+    entitlementId: string;
+    body: EntitlementGrantCreateRequest;
+}>;
+export type CreateCustomerEntitlementGrantResponse = EntitlementGrant;
+export interface ListCustomerEntitlementGrantsQuery {
+    /** Determines which page of the collection to retrieve. */
+    page?: {
+        size?: number;
+        number?: number;
+    };
+    /**
+     * Sort grants returned in the response. Supported sort attributes are:
+     *
+     * - `created_at` (default)
+     * - `updated_at`
+     * - `effective_at`
+     * - `expires_at`
+     *
+     * The `asc` suffix is optional as the default sort order is ascending. The `desc`
+     * suffix is used to specify a descending order.
+     */
+    sort?: SortQueryInput;
+    /** Include deleted grants in the response. */
+    includeDeleted?: boolean;
+}
+export type ListCustomerEntitlementGrantsRequest = AcceptDateStrings<ListCustomerEntitlementGrantsQuery & {
+    customerId: string;
+    entitlementId: string;
+}>;
+export type ListCustomerEntitlementGrantsResponse = EntitlementGrantPagePaginatedResponse;
 export type CreateCreditGrantRequest = AcceptDateStrings<{
     customerId: string;
     body: CreateCreditGrantRequestInput;

package/dist/models/schemas.d.ts

@@ -3402,6 +3402,27 @@ export declare const entitlementBoolean: z.ZodObject<{
     updatedAt: z.ZodDate;
     deletedAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>;
+export declare const entitlementGrant: z.ZodObject<{
+    id: z.ZodString;
+    entitlementId: z.ZodString;
+    amount: z.ZodString;
+    priority: z.ZodNumber;
+    effectiveAt: z.ZodDate;
+    expiresAfter: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodDate>;
+    maxRolloverAmount: z.ZodString;
+    minRolloverAmount: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        anchor: z.ZodDate;
+        interval: z.ZodString;
+    }, z.core.$strip>>;
+    nextRecurrence: z.ZodOptional<z.ZodDate>;
+    voidedAt: z.ZodOptional<z.ZodDate>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    deletedAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
 export declare const workflowCollectionAlignmentAnchored: z.ZodObject<{
     type: z.ZodLiteral<"anchored">;
     recurringPeriod: z.ZodObject<{
@@ -4722,6 +4743,36 @@ export declare const entitlement: z.ZodDiscriminatedUnion<[z.ZodObject<{
     updatedAt: z.ZodDate;
     deletedAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>], "type">;
+export declare const entitlementGrantPagePaginatedResponse: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entitlementId: z.ZodString;
+        amount: z.ZodString;
+        priority: z.ZodNumber;
+        effectiveAt: z.ZodDate;
+        expiresAfter: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodDate>;
+        maxRolloverAmount: z.ZodString;
+        minRolloverAmount: z.ZodString;
+        recurrence: z.ZodOptional<z.ZodObject<{
+            anchor: z.ZodDate;
+            interval: z.ZodString;
+        }, z.core.$strip>>;
+        nextRecurrence: z.ZodOptional<z.ZodDate>;
+        voidedAt: z.ZodOptional<z.ZodDate>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        deletedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>;
+    meta: z.ZodObject<{
+        page: z.ZodObject<{
+            number: z.ZodNumber;
+            size: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const workflowCollectionAlignment: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"subscription">;
 }, z.core.$strip>, z.ZodObject<{
@@ -19312,6 +19363,89 @@ export declare const getEntitlementResponse: z.ZodDiscriminatedUnion<[z.ZodObjec
     updatedAt: z.ZodDate;
     deletedAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>], "type">;
+export declare const createCustomerEntitlementGrantPathParams: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const createCustomerEntitlementGrantBody: z.ZodObject<{
+    amount: z.ZodString;
+    priority: z.ZodOptional<z.ZodNumber>;
+    effectiveAt: z.ZodDate;
+    expiresAfter: z.ZodOptional<z.ZodString>;
+    maxRolloverAmount: z.ZodOptional<z.ZodString>;
+    minRolloverAmount: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        interval: z.ZodString;
+        anchor: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const createCustomerEntitlementGrantResponse: z.ZodObject<{
+    id: z.ZodString;
+    entitlementId: z.ZodString;
+    amount: z.ZodString;
+    priority: z.ZodNumber;
+    effectiveAt: z.ZodDate;
+    expiresAfter: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodDate>;
+    maxRolloverAmount: z.ZodString;
+    minRolloverAmount: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        anchor: z.ZodDate;
+        interval: z.ZodString;
+    }, z.core.$strip>>;
+    nextRecurrence: z.ZodOptional<z.ZodDate>;
+    voidedAt: z.ZodOptional<z.ZodDate>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    deletedAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export declare const listCustomerEntitlementGrantsPathParams: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const listCustomerEntitlementGrantsQueryParams: z.ZodObject<{
+    page: z.ZodOptional<z.ZodObject<{
+        size: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        number: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>>;
+    sort: z.ZodOptional<z.ZodObject<{
+        by: z.ZodString;
+        order: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"asc">, z.ZodLiteral<"desc">]>>>;
+    }, z.core.$strip>>;
+    includeDeleted: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+}, z.core.$strip>;
+export declare const listCustomerEntitlementGrantsResponse: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entitlementId: z.ZodString;
+        amount: z.ZodString;
+        priority: z.ZodNumber;
+        effectiveAt: z.ZodDate;
+        expiresAfter: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodDate>;
+        maxRolloverAmount: z.ZodString;
+        minRolloverAmount: z.ZodString;
+        recurrence: z.ZodOptional<z.ZodObject<{
+            anchor: z.ZodDate;
+            interval: z.ZodString;
+        }, z.core.$strip>>;
+        nextRecurrence: z.ZodOptional<z.ZodDate>;
+        voidedAt: z.ZodOptional<z.ZodDate>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        deletedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>;
+    meta: z.ZodObject<{
+        page: z.ZodObject<{
+            number: z.ZodNumber;
+            size: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const createCreditGrantPathParams: z.ZodObject<{
     customerId: z.ZodString;
 }, z.core.$strip>;
@@ -37773,6 +37907,27 @@ export declare const entitlementBooleanWire: z.ZodObject<{
     updated_at: z.ZodString;
     deleted_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+export declare const entitlementGrantWire: z.ZodObject<{
+    id: z.ZodString;
+    entitlement_id: z.ZodString;
+    amount: z.ZodString;
+    priority: z.ZodNumber;
+    effective_at: z.ZodString;
+    expires_after: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    max_rollover_amount: z.ZodString;
+    min_rollover_amount: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        anchor: z.ZodString;
+        interval: z.ZodString;
+    }, z.core.$strict>>;
+    next_recurrence: z.ZodOptional<z.ZodString>;
+    voided_at: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    deleted_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 export declare const workflowCollectionAlignmentAnchoredWire: z.ZodObject<{
     type: z.ZodLiteral<"anchored">;
     recurring_period: z.ZodObject<{
@@ -39093,6 +39248,36 @@ export declare const entitlementWire: z.ZodDiscriminatedUnion<[z.ZodObject<{
     updated_at: z.ZodString;
     deleted_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>], "type">;
+export declare const entitlementGrantPagePaginatedResponseWire: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entitlement_id: z.ZodString;
+        amount: z.ZodString;
+        priority: z.ZodNumber;
+        effective_at: z.ZodString;
+        expires_after: z.ZodOptional<z.ZodString>;
+        expires_at: z.ZodOptional<z.ZodString>;
+        max_rollover_amount: z.ZodString;
+        min_rollover_amount: z.ZodString;
+        recurrence: z.ZodOptional<z.ZodObject<{
+            anchor: z.ZodString;
+            interval: z.ZodString;
+        }, z.core.$strict>>;
+        next_recurrence: z.ZodOptional<z.ZodString>;
+        voided_at: z.ZodOptional<z.ZodString>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        deleted_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    meta: z.ZodObject<{
+        page: z.ZodObject<{
+            number: z.ZodNumber;
+            size: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const workflowCollectionAlignmentWire: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"subscription">;
 }, z.core.$strict>, z.ZodObject<{
@@ -53668,6 +53853,86 @@ export declare const getEntitlementResponseWire: z.ZodDiscriminatedUnion<[z.ZodO
     updated_at: z.ZodString;
     deleted_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>], "type">;
+export declare const createCustomerEntitlementGrantPathParamsWire: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const createCustomerEntitlementGrantBodyWire: z.ZodObject<{
+    amount: z.ZodString;
+    priority: z.ZodOptional<z.ZodNumber>;
+    effective_at: z.ZodString;
+    expires_after: z.ZodOptional<z.ZodString>;
+    max_rollover_amount: z.ZodOptional<z.ZodString>;
+    min_rollover_amount: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        interval: z.ZodString;
+        anchor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const createCustomerEntitlementGrantResponseWire: z.ZodObject<{
+    id: z.ZodString;
+    entitlement_id: z.ZodString;
+    amount: z.ZodString;
+    priority: z.ZodNumber;
+    effective_at: z.ZodString;
+    expires_after: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    max_rollover_amount: z.ZodString;
+    min_rollover_amount: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodObject<{
+        anchor: z.ZodString;
+        interval: z.ZodString;
+    }, z.core.$strict>>;
+    next_recurrence: z.ZodOptional<z.ZodString>;
+    voided_at: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    deleted_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const listCustomerEntitlementGrantsPathParamsWire: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const listCustomerEntitlementGrantsQueryParamsWire: z.ZodObject<{
+    page: z.ZodOptional<z.ZodObject<{
+        size: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        number: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strict>>;
+    sort: z.ZodOptional<z.ZodString>;
+    include_deleted: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+}, z.core.$strip>;
+export declare const listCustomerEntitlementGrantsResponseWire: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        entitlement_id: z.ZodString;
+        amount: z.ZodString;
+        priority: z.ZodNumber;
+        effective_at: z.ZodString;
+        expires_after: z.ZodOptional<z.ZodString>;
+        expires_at: z.ZodOptional<z.ZodString>;
+        max_rollover_amount: z.ZodString;
+        min_rollover_amount: z.ZodString;
+        recurrence: z.ZodOptional<z.ZodObject<{
+            anchor: z.ZodString;
+            interval: z.ZodString;
+        }, z.core.$strict>>;
+        next_recurrence: z.ZodOptional<z.ZodString>;
+        voided_at: z.ZodOptional<z.ZodString>;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        deleted_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    meta: z.ZodObject<{
+        page: z.ZodObject<{
+            number: z.ZodNumber;
+            size: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const createCreditGrantPathParamsWire: z.ZodObject<{
     customerId: z.ZodString;
 }, z.core.$strip>;

package/dist/models/schemas.js

@@ -3484,7 +3484,7 @@ export const entitlementGrantCreateRequest = z
     labels: labels.optional(),
     recurrence: recurringPeriodInput.optional(),
 })
-    .describe('A grant created together with a metered entitlement.');
+    .describe('A grant to issue for a metered entitlement.');
 export const createEntitlementStaticRequest = z
     .object({
     type: z.literal('static').describe('The type of the entitlement.'),
@@ -3577,6 +3577,31 @@ export const entitlementBoolean = z
     deletedAt: dateTime.optional(),
 })
     .describe('A boolean entitlement grants access to a feature.');
+export const entitlementGrant = z
+    .object({
+    id: ulid,
+    entitlementId: ulid,
+    amount: numeric,
+    priority: z
+        .number()
+        .int()
+        .nonnegative()
+        .lte(255)
+        .describe('The priority of the grant. Lower values are consumed first: a grant with priority 1 is consumed before one with priority 2. Among equal priorities, the grant closest to expiration is consumed first, then the earliest created.'),
+    effectiveAt: dateTime,
+    expiresAfter: iso8601Duration.optional(),
+    expiresAt: dateTime.optional(),
+    maxRolloverAmount: numeric,
+    minRolloverAmount: numeric,
+    recurrence: recurringPeriod.optional(),
+    nextRecurrence: dateTime.optional(),
+    voidedAt: dateTime.optional(),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+})
+    .describe("A grant issued for a metered entitlement. Each grant adds its amount to the entitlement's balance from its effective time until it expires, and usage is deducted from the grants in priority order. Grants are immutable, so the balance is deterministic regardless of when it is queried. Deleting a grant ends it at the time of the deletion.");
 export const workflowCollectionAlignmentAnchored = z
     .object({
     type: z.literal('anchored').describe('The type of alignment.'),
@@ -4182,6 +4207,12 @@ export const entitlement = z
     entitlementBoolean,
 ])
     .describe('An entitlement grants a customer access to a feature.');
+export const entitlementGrantPagePaginatedResponse = z
+    .object({
+    data: z.array(entitlementGrant),
+    meta: paginatedMeta,
+})
+    .describe('Page paginated response.');
 export const workflowCollectionAlignment = z
     .discriminatedUnion('type', [
     workflowCollectionAlignmentSubscription,
@@ -5843,6 +5874,38 @@ export const getEntitlementPathParams = z.object({
     entitlementId: ulid,
 });
 export const getEntitlementResponse = entitlement;
+export const createCustomerEntitlementGrantPathParams = z.object({
+    customerId: ulid,
+    entitlementId: ulid,
+});
+export const createCustomerEntitlementGrantBody = entitlementGrantCreateRequest;
+export const createCustomerEntitlementGrantResponse = entitlementGrant;
+export const listCustomerEntitlementGrantsPathParams = z.object({
+    customerId: ulid,
+    entitlementId: ulid,
+});
+export const listCustomerEntitlementGrantsQueryParams = 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(),
+    includeDeleted: z.coerce
+        .boolean()
+        .optional()
+        .describe('Include deleted grants in the response.'),
+});
+export const listCustomerEntitlementGrantsResponse = z.object({
+    data: z.array(entitlementGrant),
+    meta: paginatedMeta,
+});
 export const createCreditGrantPathParams = z.object({
     customerId: ulid,
 });
@@ -9982,7 +10045,7 @@ export const entitlementGrantCreateRequestWire = z
     labels: labelsWire.optional(),
     recurrence: recurringPeriodInputWire.optional(),
 })
-    .describe('A grant created together with a metered entitlement.');
+    .describe('A grant to issue for a metered entitlement.');
 export const createEntitlementStaticRequestWire = z
     .strictObject({
     type: z.literal('static').describe('The type of the entitlement.'),
@@ -10072,6 +10135,31 @@ export const entitlementBooleanWire = z
     deleted_at: dateTimeWire.optional(),
 })
     .describe('A boolean entitlement grants access to a feature.');
+export const entitlementGrantWire = z
+    .strictObject({
+    id: ulidWire,
+    entitlement_id: ulidWire,
+    amount: numericWire,
+    priority: z
+        .number()
+        .int()
+        .nonnegative()
+        .lte(255)
+        .describe('The priority of the grant. Lower values are consumed first: a grant with priority 1 is consumed before one with priority 2. Among equal priorities, the grant closest to expiration is consumed first, then the earliest created.'),
+    effective_at: dateTimeWire,
+    expires_after: iso8601DurationWire.optional(),
+    expires_at: dateTimeWire.optional(),
+    max_rollover_amount: numericWire,
+    min_rollover_amount: numericWire,
+    recurrence: recurringPeriodWire.optional(),
+    next_recurrence: dateTimeWire.optional(),
+    voided_at: dateTimeWire.optional(),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+})
+    .describe("A grant issued for a metered entitlement. Each grant adds its amount to the entitlement's balance from its effective time until it expires, and usage is deducted from the grants in priority order. Grants are immutable, so the balance is deterministic regardless of when it is queried. Deleting a grant ends it at the time of the deletion.");
 export const workflowCollectionAlignmentAnchoredWire = z
     .strictObject({
     type: z.literal('anchored').describe('The type of alignment.'),
@@ -10672,6 +10760,12 @@ export const entitlementWire = z
     entitlementBooleanWire,
 ])
     .describe('An entitlement grants a customer access to a feature.');
+export const entitlementGrantPagePaginatedResponseWire = z
+    .strictObject({
+    data: z.array(entitlementGrantWire),
+    meta: paginatedMetaWire,
+})
+    .describe('Page paginated response.');
 export const workflowCollectionAlignmentWire = z
     .discriminatedUnion('type', [
     workflowCollectionAlignmentSubscriptionWire,
@@ -12347,6 +12441,41 @@ export const getEntitlementPathParamsWire = z.object({
     entitlementId: ulidWire,
 });
 export const getEntitlementResponseWire = entitlementWire;
+export const createCustomerEntitlementGrantPathParamsWire = z.object({
+    customerId: ulidWire,
+    entitlementId: ulidWire,
+});
+export const createCustomerEntitlementGrantBodyWire = entitlementGrantCreateRequestWire;
+export const createCustomerEntitlementGrantResponseWire = entitlementGrantWire;
+export const listCustomerEntitlementGrantsPathParamsWire = z.object({
+    customerId: ulidWire,
+    entitlementId: ulidWire,
+});
+export const listCustomerEntitlementGrantsQueryParamsWire = 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: z
+        .string()
+        .optional()
+        .describe('Sort grants returned in the response. Supported sort attributes are: - `created_at` (default) - `updated_at` - `effective_at` - `expires_at` The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order.'),
+    include_deleted: z.coerce
+        .boolean()
+        .optional()
+        .describe('Include deleted grants in the response.'),
+});
+export const listCustomerEntitlementGrantsResponseWire = z.strictObject({
+    data: z.array(entitlementGrantWire),
+    meta: paginatedMetaWire,
+});
 export const createCreditGrantPathParamsWire = z.object({
     customerId: ulidWire,
 });

package/dist/models/types.d.ts

@@ -3444,7 +3444,7 @@ export interface AppStripeCreateCheckoutSessionConsentCollection {
      */
     termsOfService?: 'none' | 'required';
 }
-/** A grant created together with a metered entitlement. */
+/** A grant to issue for a metered entitlement. */
 export interface EntitlementGrantCreateRequest {
     /** The amount to grant, in the feature's unit. Must be positive. */
     amount: string;
@@ -3456,7 +3456,7 @@ export interface EntitlementGrantCreateRequest {
     priority?: number;
     /**
      * The time the grant becomes effective and the anchor for recurring grants. The
-     * value is rounded up to the next minute.
+     * value is truncated to the start of the minute.
      */
     effectiveAt: Date;
     /**
@@ -3628,6 +3628,71 @@ export interface EntitlementBoolean {
     /** The time the entitlement was deleted. */
     deletedAt?: Date;
 }
+/**
+ * A grant issued for a metered entitlement. Each grant adds its amount to the
+ * entitlement's balance from its effective time until it expires, and usage is
+ * deducted from the grants in priority order.
+ *
+ * Grants are immutable, so the balance is deterministic regardless of when it is
+ * queried. Deleting a grant ends it at the time of the deletion.
+ */
+export interface EntitlementGrant {
+    id: string;
+    /** The ID of the entitlement the grant belongs to. */
+    entitlementId: string;
+    /** The granted amount, in the feature's unit. */
+    amount: string;
+    /**
+     * The priority of the grant. Lower values are consumed first: a grant with
+     * priority 1 is consumed before one with priority 2. Among equal priorities, the
+     * grant closest to expiration is consumed first, then the earliest created.
+     */
+    priority: number;
+    /** The time the grant takes effect. */
+    effectiveAt: Date;
+    /**
+     * The duration after which the grant expires, counted from `effective_at`. Always
+     * a single-unit duration (for example `PT12H`, `P7D`, `P2W`, `P3M`, `P1Y`). Absent
+     * when the grant never expires.
+     */
+    expiresAfter?: string;
+    /**
+     * The time the grant expires, calculated from `effective_at` and `expires_after`.
+     * The grant is no longer in effect from this time. Absent when the grant never
+     * expires.
+     */
+    expiresAt?: Date;
+    /**
+     * The maximum balance the grant carries over at reset. The balance after a reset
+     * is `MIN(max_rollover_amount, MAX(balance_before_reset, min_rollover_amount))`.
+     */
+    maxRolloverAmount: string;
+    /**
+     * The minimum balance the grant carries over at reset. The balance after a reset
+     * is `MIN(max_rollover_amount, MAX(balance_before_reset, min_rollover_amount))`.
+     */
+    minRolloverAmount: string;
+    /**
+     * The recurrence of the grant. When set, the grant amount is re-issued every
+     * interval from the anchor, which defaults to `effective_at`. Absent for
+     * non-recurring grants.
+     */
+    recurrence?: RecurringPeriod;
+    /** The next time the grant recurs. Absent for non-recurring grants. */
+    nextRecurrence?: Date;
+    /**
+     * The time the grant was voided. A voided grant is no longer in effect from this
+     * time.
+     */
+    voidedAt?: Date;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    createdAt: Date;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updatedAt: Date;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deletedAt?: Date;
+}
 /**
  * BillingWorkflowCollectionAlignmentAnchored specifies the alignment for
  * collecting the pending line items into an invoice.
@@ -4494,6 +4559,11 @@ export interface CreateEntitlementMeteredRequest {
     /** Grants created together with the entitlement. Cannot be combined with `issue`. */
     grants?: EntitlementGrantCreateRequest[];
 }
+/** Page paginated response. */
+export interface EntitlementGrantPagePaginatedResponse {
+    data: EntitlementGrant[];
+    meta: PaginatedMeta;
+}
 /** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface InvoiceWorkflowSettings {
     /** The apps that will be used to orchestrate the invoice's workflow. */

package/dist/sdk/internal.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from '../core.js';
 import { type RequestOptions } from '../lib/types.js';
-import type { CreateCustomerEntitlementRequest, CreateCustomerEntitlementResponse, OverrideCustomerEntitlementRequest, OverrideCustomerEntitlementResponse, GetCustomerEntitlementHistoryRequest, GetCustomerEntitlementHistoryResponse, GetCustomerEntitlementRequest, GetCustomerEntitlementResponse, ListCustomerEntitlementsRequest, ListCustomerEntitlementsResponse, ResetCustomerEntitlementUsageRequest, ResetCustomerEntitlementUsageResponse, DeleteCustomerEntitlementRequest, DeleteCustomerEntitlementResponse, VoidCreditGrantRequest, VoidCreditGrantResponse, ListCustomerChargesRequest, ListCustomerChargesResponse, CreateCustomerChargesRequest, CreateCustomerChargesResponse } from '../models/operations/customers.js';
+import type { CreateCustomerEntitlementRequest, CreateCustomerEntitlementResponse, OverrideCustomerEntitlementRequest, OverrideCustomerEntitlementResponse, GetCustomerEntitlementHistoryRequest, GetCustomerEntitlementHistoryResponse, GetCustomerEntitlementRequest, GetCustomerEntitlementResponse, ListCustomerEntitlementsRequest, ListCustomerEntitlementsResponse, ResetCustomerEntitlementUsageRequest, ResetCustomerEntitlementUsageResponse, DeleteCustomerEntitlementRequest, DeleteCustomerEntitlementResponse, CreateCustomerEntitlementGrantRequest, CreateCustomerEntitlementGrantResponse, ListCustomerEntitlementGrantsRequest, ListCustomerEntitlementGrantsResponse, VoidCreditGrantRequest, VoidCreditGrantResponse, ListCustomerChargesRequest, ListCustomerChargesResponse, CreateCustomerChargesRequest, CreateCustomerChargesResponse } from '../models/operations/customers.js';
 import type { GetCustomerEntitlementAccessRequest, GetCustomerEntitlementAccessResponse, ListEntitlementsRequest, ListEntitlementsResponse, GetEntitlementRequest, GetEntitlementResponse } from '../models/operations/entitlements.js';
 import type { UnscheduleSubscriptionRequest, UnscheduleSubscriptionResponse, RestoreSubscriptionRequest, RestoreSubscriptionResponse, MigrateSubscriptionRequest, MigrateSubscriptionResponse, CreateSubscriptionAddonRequest, CreateSubscriptionAddonResponse, UpdateSubscriptionAddonRequest, UpdateSubscriptionAddonResponse } from '../models/operations/subscriptions.js';
 import type { UninstallAppRequest, UninstallAppResponse, UpdateAppRequest, UpdateAppResponse, ListAppCatalogRequest, ListAppCatalogResponse, GetAppCatalogItemRequest, GetAppCatalogItemResponse, InstallAppRequest, InstallAppResponse } from '../models/operations/apps.js';
@@ -10,7 +10,7 @@ import type { ListCurrenciesRequest, ListCurrenciesResponse, CreateCustomCurrenc
 import type { ListPlanAddonsRequest, ListPlanAddonsResponse } from '../models/operations/planAddons.js';
 import type { QueryEntitlementAccessRequest, QueryEntitlementAccessResponse } from '../models/operations/entitlementAccess.js';
 import type { ListNotificationChannelsRequest, ListNotificationChannelsResponse, CreateNotificationChannelRequest, CreateNotificationChannelResponse, GetNotificationChannelRequest, GetNotificationChannelResponse, UpdateNotificationChannelRequest, UpdateNotificationChannelResponse, DeleteNotificationChannelRequest, DeleteNotificationChannelResponse } from '../models/operations/notifications.js';
-import type { AppCatalogItem, Charge, CostBasis, Currency, Entitlement, Invoice, NotificationChannel, PlanAddon } from '../models/types.js';
+import type { AppCatalogItem, Charge, CostBasis, Currency, Entitlement, EntitlementGrant, Invoice, NotificationChannel, PlanAddon } 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
@@ -152,6 +152,50 @@ export declare class InternalCustomersEntitlements {
      * DELETE /openmeter/customers/{customerId}/entitlements/{entitlementId}
      */
     delete(request: DeleteCustomerEntitlementRequest, options?: RequestOptions): Promise<DeleteCustomerEntitlementResponse>;
+    private _grants?;
+    get grants(): InternalCustomersEntitlementsGrants;
+}
+export declare class InternalCustomersEntitlementsGrants {
+    private readonly _client;
+    constructor(_client: Client);
+    /**
+     * Create customer entitlement grant
+     *
+     * Issue a grant for a metered entitlement of the customer. Boolean and static
+     * entitlements cannot have grants, so the request is rejected for them.
+     *
+     * Grants are immutable. The amount is added to the balance from `effective_at`,
+     * which cannot be earlier than the start of the current usage period.
+     *
+     * POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    create(request: CreateCustomerEntitlementGrantRequest, options?: RequestOptions): Promise<CreateCustomerEntitlementGrantResponse>;
+    /**
+     * List customer entitlement grants
+     *
+     * List the grants issued for an entitlement of the customer. Grants only exist for
+     * metered entitlements, so the list is empty for boolean and static entitlements.
+     *
+     * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+     * grants are always included, as they are part of the balance history.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    list(request: ListCustomerEntitlementGrantsRequest, options?: RequestOptions): Promise<ListCustomerEntitlementGrantsResponse>;
+    /**
+     * List customer entitlement grants
+     *
+     * List the grants issued for an entitlement of the customer. Grants only exist for
+     * metered entitlements, so the list is empty for boolean and static entitlements.
+     *
+     * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+     * grants are always included, as they are part of the balance history.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    listAll(request: ListCustomerEntitlementGrantsRequest, options?: RequestOptions): AsyncIterable<EntitlementGrant>;
 }
 export declare class InternalCustomersCredits {
     private readonly _client;

package/dist/sdk/internal.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 { createCustomerEntitlement, overrideCustomerEntitlement, getCustomerEntitlementHistory, getCustomerEntitlement, listCustomerEntitlements, resetCustomerEntitlementUsage, deleteCustomerEntitlement, voidCreditGrant, listCustomerCharges, createCustomerCharges, } from '../funcs/customers.js';
+import { createCustomerEntitlement, overrideCustomerEntitlement, getCustomerEntitlementHistory, getCustomerEntitlement, listCustomerEntitlements, resetCustomerEntitlementUsage, deleteCustomerEntitlement, createCustomerEntitlementGrant, listCustomerEntitlementGrants, voidCreditGrant, listCustomerCharges, createCustomerCharges, } from '../funcs/customers.js';
 import { getCustomerEntitlementAccess, listEntitlements, getEntitlement, } from '../funcs/entitlements.js';
 import { unscheduleSubscription, restoreSubscription, migrateSubscription, createSubscriptionAddon, updateSubscriptionAddon, } from '../funcs/subscriptions.js';
 import { uninstallApp, updateApp, listAppCatalog, getAppCatalogItem, installApp, } from '../funcs/apps.js';
@@ -200,6 +200,60 @@ export class InternalCustomersEntitlements {
     async delete(request, options) {
         return unwrap(await deleteCustomerEntitlement(this._client, request, options));
     }
+    _grants;
+    get grants() {
+        return (this._grants ??= new InternalCustomersEntitlementsGrants(this._client));
+    }
+}
+export class InternalCustomersEntitlementsGrants {
+    _client;
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * Create customer entitlement grant
+     *
+     * Issue a grant for a metered entitlement of the customer. Boolean and static
+     * entitlements cannot have grants, so the request is rejected for them.
+     *
+     * Grants are immutable. The amount is added to the balance from `effective_at`,
+     * which cannot be earlier than the start of the current usage period.
+     *
+     * POST /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    async create(request, options) {
+        return unwrap(await createCustomerEntitlementGrant(this._client, request, options));
+    }
+    /**
+     * List customer entitlement grants
+     *
+     * List the grants issued for an entitlement of the customer. Grants only exist for
+     * metered entitlements, so the list is empty for boolean and static entitlements.
+     *
+     * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+     * grants are always included, as they are part of the balance history.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    async list(request, options) {
+        return unwrap(await listCustomerEntitlementGrants(this._client, request, options));
+    }
+    /**
+     * List customer entitlement grants
+     *
+     * List the grants issued for an entitlement of the customer. Grants only exist for
+     * metered entitlements, so the list is empty for boolean and static entitlements.
+     *
+     * Deleted grants are excluded unless `include_deleted` is set. Voided and expired
+     * grants are always included, as they are part of the balance history.
+     *
+     * Iterates every item across all pages, fetching more as the returned iterable is consumed.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/grants
+     */
+    listAll(request, options) {
+        return paginatePages((req, opts) => listCustomerEntitlementGrants(this._client, req, opts), request, options);
+    }
 }
 export class InternalCustomersCredits {
     _client;

package/package.json

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