@openmeter/client 1.0.0-beta-0abbaf78837c → 1.0.0-beta-7f901f655a1a

package/README.md

@@ -444,6 +444,7 @@ they can change or be removed without notice or semver consideration.
 | `client.internal.entitlements.getCustomerAccess` | `GET /openmeter/customers/{customerId}/entitlement-access/features/{featureKey}` | Get the customer's access to a single feature.                                                                                                                                                                                             |
 | `client.internal.entitlements.list`              | `GET /openmeter/entitlements`                                                    | List the active entitlements of all customers. Intended for administrative use. To list the entitlements of a single customer, use the customer entitlements endpoints; to check entitlement access, use the entitlement access endpoints. |
 | `client.internal.entitlements.get`               | `GET /openmeter/entitlements/{entitlementId}`                                    | Get an entitlement by ID. To check entitlement access, use the entitlement access endpoints instead.                                                                                                                                       |
+| `client.internal.entitlements.getCustomerValue`  | `GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/value`       | Get the customer's access through a single entitlement, optionally evaluated at a point in time.                                                                                                                                           |
 
 ### Internal Subscriptions
 

package/dist/funcs/entitlements.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from '../core.js';
 import { type Result, type RequestOptions } from '../lib/types.js';
-import type { ListCustomerEntitlementAccessRequest, ListCustomerEntitlementAccessResponse, GetCustomerEntitlementAccessRequest, GetCustomerEntitlementAccessResponse, ListEntitlementsRequest, ListEntitlementsResponse, GetEntitlementRequest, GetEntitlementResponse } from '../models/operations/entitlements.js';
+import type { ListCustomerEntitlementAccessRequest, ListCustomerEntitlementAccessResponse, GetCustomerEntitlementAccessRequest, GetCustomerEntitlementAccessResponse, ListEntitlementsRequest, ListEntitlementsResponse, GetEntitlementRequest, GetEntitlementResponse, GetCustomerEntitlementValueRequest, GetCustomerEntitlementValueResponse } from '../models/operations/entitlements.js';
 /**
  * List customer entitlement access
  *
@@ -34,3 +34,12 @@ export declare function listEntitlements(client: Client, req?: ListEntitlementsR
  * GET /openmeter/entitlements/{entitlementId}
  */
 export declare function getEntitlement(client: Client, req: GetEntitlementRequest, options?: RequestOptions): Promise<Result<GetEntitlementResponse>>;
+/**
+ * Get customer entitlement value
+ *
+ * Get the customer's access through a single entitlement, optionally evaluated at
+ * a point in time.
+ *
+ * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/value
+ */
+export declare function getCustomerEntitlementValue(client: Client, req: GetCustomerEntitlementValueRequest, options?: RequestOptions): Promise<Result<GetCustomerEntitlementValueResponse>>;

package/dist/funcs/entitlements.js

@@ -67,15 +67,8 @@ export function getCustomerEntitlementAccess(client, req, options) {
             }
             return encodeURIComponent(String(pathParams.featureKey));
         })()}`;
-        const query = toWire({
-            expand: req.expand,
-        }, schemas.getCustomerEntitlementAccessQueryParams);
-        if (client._options.validate) {
-            assertValid(schemas.getCustomerEntitlementAccessQueryParamsWire, query);
-        }
-        const searchParams = toURLSearchParams(query);
         return http(client)
-            .get(path, { ...options, searchParams })
+            .get(path, options)
             .json()
             .then((data) => {
             if (client._options.validate) {
@@ -155,3 +148,53 @@ export function getEntitlement(client, req, options) {
         });
     });
 }
+/**
+ * Get customer entitlement value
+ *
+ * Get the customer's access through a single entitlement, optionally evaluated at
+ * a point in time.
+ *
+ * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/value
+ */
+export function getCustomerEntitlementValue(client, req, options) {
+    return request(() => {
+        const pathParamsInput = {
+            customerId: req.customerId,
+            entitlementId: req.entitlementId,
+        };
+        const pathParams = client._options.validate
+            ? toPathWire(pathParamsInput, schemas.getCustomerEntitlementValuePathParams)
+            : pathParamsInput;
+        if (client._options.validate) {
+            assertValid(schemas.getCustomerEntitlementValuePathParamsWire, 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));
+        })()}/value`;
+        const query = toWire({
+            expand: req.expand,
+            at: req.at,
+        }, schemas.getCustomerEntitlementValueQueryParams);
+        if (client._options.validate) {
+            assertValid(schemas.getCustomerEntitlementValueQueryParamsWire, query);
+        }
+        const searchParams = toURLSearchParams(query);
+        return http(client)
+            .get(path, { ...options, searchParams })
+            .json()
+            .then((data) => {
+            if (client._options.validate) {
+                assertValid(schemas.getCustomerEntitlementValueResponseWire, data);
+            }
+            return fromWire(data, schemas.getCustomerEntitlementValueResponse);
+        });
+    });
+}

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, 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';
+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, EntitlementAccessCheckResult, 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, EntitlementValueResult, 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-0abbaf78837c";
+export declare const SDK_VERSION = "1.0.0-beta-7f901f655a1a";

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

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

@@ -1,25 +1,14 @@
 import type { AcceptDateStrings } from '../../lib/wire.js';
-import type { Entitlement, EntitlementAccessResult, EntitlementPagePaginatedResponse, ListCustomerEntitlementAccessResponseData, ListEntitlementsParamsFilter, SortQueryInput } from '../types.js';
+import type { Entitlement, EntitlementAccessCheckResult, EntitlementPagePaginatedResponse, EntitlementValueResult, ListCustomerEntitlementAccessResponseData, ListEntitlementsParamsFilter, SortQueryInput } from '../types.js';
 export type ListCustomerEntitlementAccessRequest = {
     customerId: string;
 };
 export type ListCustomerEntitlementAccessResponse = ListCustomerEntitlementAccessResponseData;
-export interface GetCustomerEntitlementAccessQuery {
-    /**
-     * Expand computed fields.
-     *
-     * Supported values are:
-     *
-     * - `value`: Expand the balance details of a metered entitlement; it sets the
-     * `value` field.
-     */
-    expand?: 'value'[];
-}
-export type GetCustomerEntitlementAccessRequest = AcceptDateStrings<GetCustomerEntitlementAccessQuery & {
+export type GetCustomerEntitlementAccessRequest = {
     customerId: string;
     featureKey: string;
-}>;
-export type GetCustomerEntitlementAccessResponse = EntitlementAccessResult;
+};
+export type GetCustomerEntitlementAccessResponse = EntitlementAccessCheckResult;
 export interface ListEntitlementsQuery {
     /** Determines which page of the collection to retrieve. */
     page?: {
@@ -50,3 +39,21 @@ export type GetEntitlementRequest = {
     entitlementId: string;
 };
 export type GetEntitlementResponse = Entitlement;
+export interface GetCustomerEntitlementValueQuery {
+    /**
+     * Expand computed fields.
+     *
+     * Supported values are:
+     *
+     * - `value`: Expand the balance details of a metered entitlement; it sets the
+     * `value` field.
+     */
+    expand?: 'value'[];
+    /** The point in time to evaluate the entitlement at. Defaults to the current time. */
+    at?: Date;
+}
+export type GetCustomerEntitlementValueRequest = AcceptDateStrings<GetCustomerEntitlementValueQuery & {
+    customerId: string;
+    entitlementId: string;
+}>;
+export type GetCustomerEntitlementValueResponse = EntitlementValueResult;

package/dist/models/schemas.d.ts

@@ -170,9 +170,6 @@ export declare const entitlementType: z.ZodEnum<{
     metered: "metered";
     static: "static";
 }>;
-export declare const entitlementAccessExpand: z.ZodEnum<{
-    value: "value";
-}>;
 export declare const iso8601Duration: z.ZodString;
 export declare const entitlementMeasureUsageFromPreset: z.ZodEnum<{
     current_period_start: "current_period_start";
@@ -184,6 +181,9 @@ export declare const stringFieldFilterExact: z.ZodUnion<readonly [z.ZodString, z
     oeq: z.ZodOptional<z.ZodArray<z.ZodString>>;
     neq: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>]>;
+export declare const entitlementAccessExpand: z.ZodEnum<{
+    value: "value";
+}>;
 export declare const createLabels: z.ZodRecord<z.ZodString, z.ZodString>;
 export declare const creditFundingMethod: z.ZodEnum<{
     external: "external";
@@ -1390,6 +1390,15 @@ export declare const customerStripeCreateCustomerPortalSessionRequest: z.ZodObje
         returnUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const entitlementAccessCheckResult: z.ZodObject<{
+    hasAccess: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        boolean: "boolean";
+        metered: "metered";
+        static: "static";
+    }>>;
+}, z.core.$strip>;
 export declare const recurringPeriodInput: z.ZodObject<{
     interval: z.ZodString;
     anchor: z.ZodOptional<z.ZodDate>;
@@ -1864,7 +1873,7 @@ export declare const currencyAmount: z.ZodObject<{
     amount: z.ZodString;
     currency: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
 }, z.core.$strip>;
-export declare const entitlementAccessResult: z.ZodObject<{
+export declare const entitlementValueResult: z.ZodObject<{
     type: z.ZodEnum<{
         boolean: "boolean";
         metered: "metered";
@@ -18594,27 +18603,14 @@ export declare const getCustomerEntitlementAccessPathParams: z.ZodObject<{
     customerId: z.ZodString;
     featureKey: z.ZodString;
 }, z.core.$strip>;
-export declare const getCustomerEntitlementAccessQueryParams: z.ZodObject<{
-    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        value: "value";
-    }>>>;
-}, z.core.$strip>;
 export declare const getCustomerEntitlementAccessResponse: z.ZodObject<{
-    type: z.ZodEnum<{
+    hasAccess: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
         boolean: "boolean";
         metered: "metered";
         static: "static";
-    }>;
-    featureKey: z.ZodString;
-    hasAccess: z.ZodBoolean;
-    config: z.ZodOptional<z.ZodString>;
-    value: z.ZodOptional<z.ZodObject<{
-        balance: z.ZodString;
-        usage: z.ZodString;
-        overage: z.ZodString;
-        totalAvailableGrantAmount: z.ZodString;
-        grantBalances: z.ZodRecord<z.ZodString, z.ZodString>;
-    }, z.core.$strip>>;
+    }>>;
 }, z.core.$strip>;
 export declare const createCustomerEntitlementPathParams: z.ZodObject<{
     customerId: z.ZodString;
@@ -19446,6 +19442,33 @@ export declare const listCustomerEntitlementGrantsResponse: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const getCustomerEntitlementValuePathParams: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const getCustomerEntitlementValueQueryParams: z.ZodObject<{
+    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        value: "value";
+    }>>>;
+    at: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export declare const getCustomerEntitlementValueResponse: z.ZodObject<{
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        metered: "metered";
+        static: "static";
+    }>;
+    featureKey: z.ZodString;
+    hasAccess: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodObject<{
+        balance: z.ZodString;
+        usage: z.ZodString;
+        overage: z.ZodString;
+        totalAvailableGrantAmount: z.ZodString;
+        grantBalances: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const createCreditGrantPathParams: z.ZodObject<{
     customerId: z.ZodString;
 }, z.core.$strip>;
@@ -34675,9 +34698,6 @@ export declare const entitlementTypeWire: z.ZodEnum<{
     metered: "metered";
     static: "static";
 }>;
-export declare const entitlementAccessExpandWire: z.ZodEnum<{
-    value: "value";
-}>;
 export declare const iso8601DurationWire: z.ZodString;
 export declare const entitlementMeasureUsageFromPresetWire: z.ZodEnum<{
     current_period_start: "current_period_start";
@@ -34689,6 +34709,9 @@ export declare const stringFieldFilterExactWire: z.ZodUnion<readonly [z.ZodStrin
     oeq: z.ZodOptional<z.ZodArray<z.ZodString>>;
     neq: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
+export declare const entitlementAccessExpandWire: z.ZodEnum<{
+    value: "value";
+}>;
 export declare const createLabelsWire: z.ZodRecord<z.ZodString, z.ZodString>;
 export declare const creditFundingMethodWire: z.ZodEnum<{
     external: "external";
@@ -35895,6 +35918,15 @@ export declare const customerStripeCreateCustomerPortalSessionRequestWire: z.Zod
         return_url: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const entitlementAccessCheckResultWire: z.ZodObject<{
+    has_access: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        boolean: "boolean";
+        metered: "metered";
+        static: "static";
+    }>>;
+}, z.core.$strict>;
 export declare const recurringPeriodInputWire: z.ZodObject<{
     interval: z.ZodString;
     anchor: z.ZodOptional<z.ZodString>;
@@ -36369,7 +36401,7 @@ export declare const currencyAmountWire: z.ZodObject<{
     amount: z.ZodString;
     currency: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
 }, z.core.$strict>;
-export declare const entitlementAccessResultWire: z.ZodObject<{
+export declare const entitlementValueResultWire: z.ZodObject<{
     type: z.ZodEnum<{
         boolean: "boolean";
         metered: "metered";
@@ -53090,27 +53122,14 @@ export declare const getCustomerEntitlementAccessPathParamsWire: z.ZodObject<{
     customerId: z.ZodString;
     featureKey: z.ZodString;
 }, z.core.$strip>;
-export declare const getCustomerEntitlementAccessQueryParamsWire: z.ZodObject<{
-    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        value: "value";
-    }>>>;
-}, z.core.$strip>;
 export declare const getCustomerEntitlementAccessResponseWire: z.ZodObject<{
-    type: z.ZodEnum<{
+    has_access: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
         boolean: "boolean";
         metered: "metered";
         static: "static";
-    }>;
-    feature_key: z.ZodString;
-    has_access: z.ZodBoolean;
-    config: z.ZodOptional<z.ZodString>;
-    value: z.ZodOptional<z.ZodObject<{
-        balance: z.ZodString;
-        usage: z.ZodString;
-        overage: z.ZodString;
-        total_available_grant_amount: z.ZodString;
-        grant_balances: z.ZodRecord<z.ZodString, z.ZodString>;
-    }, z.core.$strict>>;
+    }>>;
 }, z.core.$strict>;
 export declare const createCustomerEntitlementPathParamsWire: z.ZodObject<{
     customerId: z.ZodString;
@@ -53933,6 +53952,33 @@ export declare const listCustomerEntitlementGrantsResponseWire: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const getCustomerEntitlementValuePathParamsWire: z.ZodObject<{
+    customerId: z.ZodString;
+    entitlementId: z.ZodString;
+}, z.core.$strip>;
+export declare const getCustomerEntitlementValueQueryParamsWire: z.ZodObject<{
+    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        value: "value";
+    }>>>;
+    at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getCustomerEntitlementValueResponseWire: z.ZodObject<{
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        metered: "metered";
+        static: "static";
+    }>;
+    feature_key: z.ZodString;
+    has_access: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodObject<{
+        balance: z.ZodString;
+        usage: z.ZodString;
+        overage: z.ZodString;
+        total_available_grant_amount: z.ZodString;
+        grant_balances: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const createCreditGrantPathParamsWire: z.ZodObject<{
     customerId: z.ZodString;
 }, z.core.$strip>;

package/dist/models/schemas.js

@@ -375,9 +375,6 @@ export const appStripeCreateCustomerPortalSessionOptions = z
 export const entitlementType = z
     .enum(['metered', 'static', 'boolean'])
     .describe('The type of the entitlement.');
-export const entitlementAccessExpand = z
-    .enum(['value'])
-    .describe('Expands for customer entitlement access. Values: - `value`: The balance details of a metered entitlement; it sets the `value` field.');
 export const iso8601Duration = z
     .string()
     .regex(new RegExp('^P(?:\\d+(?:\\.\\d+)?Y)?(?:\\d+(?:\\.\\d+)?M)?(?:\\d+(?:\\.\\d+)?W)?(?:\\d+(?:\\.\\d+)?D)?(?:T(?:\\d+(?:\\.\\d+)?H)?(?:\\d+(?:\\.\\d+)?M)?(?:\\d+(?:\\.\\d+)?S)?)?$'))
@@ -407,6 +404,9 @@ export const stringFieldFilterExact = z
     }),
 ])
     .describe('Filters on the given string field value by exact match. All properties are optional; provide exactly one to specify the comparison.');
+export const entitlementAccessExpand = z
+    .enum(['value'])
+    .describe('Expands for customer entitlement access. Values: - `value`: The balance details of a metered entitlement; it sets the `value` field.');
 export const createLabels = z
     .record(z.string(), z.string())
     .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
@@ -1252,7 +1252,7 @@ export const entitlementAccessValue = z
         .record(z.string(), numeric)
         .describe('The remaining balance of each grant, keyed by grant ID.'),
 })
-    .describe('Balance details of a metered entitlement.');
+    .describe('Balance details of a metered entitlement at the evaluation time, which is the `at` query parameter when given and the current time otherwise.');
 export const entitlementIssueAfterReset = z
     .object({
     amount: numeric,
@@ -2257,6 +2257,18 @@ export const customerStripeCreateCustomerPortalSessionRequest = z
     stripeOptions: appStripeCreateCustomerPortalSessionOptions,
 })
     .describe('Request to create a Stripe Customer Portal Session for the customer. Useful to redirect the customer to the Stripe Customer Portal to manage their payment methods, change their billing address and access their invoice history. Only returns URL if the customer billing profile is linked to a stripe app and customer.');
+export const entitlementAccessCheckResult = z
+    .object({
+    hasAccess: z
+        .boolean()
+        .describe('Whether the customer has access to the feature. Always true for `boolean` and `static` entitlements. Depends on balance for `metered` entitlements.'),
+    config: z
+        .string()
+        .optional()
+        .describe('Only available for static entitlements. Config is the JSON parsable configuration of the entitlement. Useful to describe per customer configuration.'),
+    type: entitlementType.optional(),
+})
+    .describe('Entitlement access check result.');
 export const recurringPeriodInput = z
     .object({
     interval: iso8601Duration,
@@ -2787,7 +2799,7 @@ export const currencyAmount = z
     currency: billingCurrencyCode,
 })
     .describe('Monetary amount in a fiat or custom currency.');
-export const entitlementAccessResult = z
+export const entitlementValueResult = z
     .object({
     type: entitlementType,
     featureKey: resourceKey,
@@ -2800,7 +2812,7 @@ export const entitlementAccessResult = z
         .describe('Only available for static entitlements. Config is the JSON parsable configuration of the entitlement. Useful to describe per customer configuration.'),
     value: entitlementAccessValue.optional(),
 })
-    .describe('Entitlement access result.');
+    .describe('Entitlement value result.');
 export const priceTier = z
     .object({
     upToAmount: numeric.optional(),
@@ -3892,7 +3904,7 @@ export const chargeFlatFeeSystemIntent = z
 export const listCustomerEntitlementAccessResponseData = z
     .object({
     data: z
-        .array(entitlementAccessResult)
+        .array(entitlementValueResult)
         .describe('The list of entitlement access results.'),
 })
     .describe('List customer entitlement access response data.');
@@ -5782,13 +5794,7 @@ export const getCustomerEntitlementAccessPathParams = z.object({
     customerId: ulid,
     featureKey: resourceKey,
 });
-export const getCustomerEntitlementAccessQueryParams = z.object({
-    expand: z
-        .array(entitlementAccessExpand)
-        .optional()
-        .describe('Expand computed fields. Supported values are: - `value`: Expand the balance details of a metered entitlement; it sets the `value` field.'),
-});
-export const getCustomerEntitlementAccessResponse = entitlementAccessResult;
+export const getCustomerEntitlementAccessResponse = entitlementAccessCheckResult;
 export const createCustomerEntitlementPathParams = z.object({
     customerId: ulid,
 });
@@ -5906,6 +5912,18 @@ export const listCustomerEntitlementGrantsResponse = z.object({
     data: z.array(entitlementGrant),
     meta: paginatedMeta,
 });
+export const getCustomerEntitlementValuePathParams = z.object({
+    customerId: ulid,
+    entitlementId: ulid,
+});
+export const getCustomerEntitlementValueQueryParams = z.object({
+    expand: z
+        .array(entitlementAccessExpand)
+        .optional()
+        .describe('Expand computed fields. Supported values are: - `value`: Expand the balance details of a metered entitlement; it sets the `value` field.'),
+    at: dateTime.optional(),
+});
+export const getCustomerEntitlementValueResponse = entitlementValueResult;
 export const createCreditGrantPathParams = z.object({
     customerId: ulid,
 });
@@ -6967,9 +6985,6 @@ export const appStripeCreateCustomerPortalSessionOptionsWire = z
 export const entitlementTypeWire = z
     .enum(['metered', 'static', 'boolean'])
     .describe('The type of the entitlement.');
-export const entitlementAccessExpandWire = z
-    .enum(['value'])
-    .describe('Expands for customer entitlement access. Values: - `value`: The balance details of a metered entitlement; it sets the `value` field.');
 export const iso8601DurationWire = z
     .string()
     .regex(new RegExp('^P(?:\\d+(?:\\.\\d+)?Y)?(?:\\d+(?:\\.\\d+)?M)?(?:\\d+(?:\\.\\d+)?W)?(?:\\d+(?:\\.\\d+)?D)?(?:T(?:\\d+(?:\\.\\d+)?H)?(?:\\d+(?:\\.\\d+)?M)?(?:\\d+(?:\\.\\d+)?S)?)?$'))
@@ -6999,6 +7014,9 @@ export const stringFieldFilterExactWire = z
     }),
 ])
     .describe('Filters on the given string field value by exact match. All properties are optional; provide exactly one to specify the comparison.');
+export const entitlementAccessExpandWire = z
+    .enum(['value'])
+    .describe('Expands for customer entitlement access. Values: - `value`: The balance details of a metered entitlement; it sets the `value` field.');
 export const createLabelsWire = z
     .record(z.string(), z.string())
     .describe('Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\\_".');
@@ -7838,7 +7856,7 @@ export const entitlementAccessValueWire = z
         .record(z.string(), numericWire)
         .describe('The remaining balance of each grant, keyed by grant ID.'),
 })
-    .describe('Balance details of a metered entitlement.');
+    .describe('Balance details of a metered entitlement at the evaluation time, which is the `at` query parameter when given and the current time otherwise.');
 export const entitlementIssueAfterResetWire = z
     .strictObject({
     amount: numericWire,
@@ -8831,6 +8849,18 @@ export const customerStripeCreateCustomerPortalSessionRequestWire = z
     stripe_options: appStripeCreateCustomerPortalSessionOptionsWire,
 })
     .describe('Request to create a Stripe Customer Portal Session for the customer. Useful to redirect the customer to the Stripe Customer Portal to manage their payment methods, change their billing address and access their invoice history. Only returns URL if the customer billing profile is linked to a stripe app and customer.');
+export const entitlementAccessCheckResultWire = z
+    .strictObject({
+    has_access: z
+        .boolean()
+        .describe('Whether the customer has access to the feature. Always true for `boolean` and `static` entitlements. Depends on balance for `metered` entitlements.'),
+    config: z
+        .string()
+        .optional()
+        .describe('Only available for static entitlements. Config is the JSON parsable configuration of the entitlement. Useful to describe per customer configuration.'),
+    type: entitlementTypeWire.optional(),
+})
+    .describe('Entitlement access check result.');
 export const recurringPeriodInputWire = z
     .strictObject({
     interval: iso8601DurationWire,
@@ -9348,7 +9378,7 @@ export const currencyAmountWire = z
     currency: billingCurrencyCodeWire,
 })
     .describe('Monetary amount in a fiat or custom currency.');
-export const entitlementAccessResultWire = z
+export const entitlementValueResultWire = z
     .strictObject({
     type: entitlementTypeWire,
     feature_key: resourceKeyWire,
@@ -9361,7 +9391,7 @@ export const entitlementAccessResultWire = z
         .describe('Only available for static entitlements. Config is the JSON parsable configuration of the entitlement. Useful to describe per customer configuration.'),
     value: entitlementAccessValueWire.optional(),
 })
-    .describe('Entitlement access result.');
+    .describe('Entitlement value result.');
 export const priceTierWire = z
     .strictObject({
     up_to_amount: numericWire.optional(),
@@ -10452,7 +10482,7 @@ export const chargeFlatFeeSystemIntentWire = z
 export const listCustomerEntitlementAccessResponseDataWire = z
     .strictObject({
     data: z
-        .array(entitlementAccessResultWire)
+        .array(entitlementValueResultWire)
         .describe('The list of entitlement access results.'),
 })
     .describe('List customer entitlement access response data.');
@@ -12344,13 +12374,7 @@ export const getCustomerEntitlementAccessPathParamsWire = z.object({
     customerId: ulidWire,
     featureKey: resourceKeyWire,
 });
-export const getCustomerEntitlementAccessQueryParamsWire = z.object({
-    expand: z
-        .array(entitlementAccessExpandWire)
-        .optional()
-        .describe('Expand computed fields. Supported values are: - `value`: Expand the balance details of a metered entitlement; it sets the `value` field.'),
-});
-export const getCustomerEntitlementAccessResponseWire = entitlementAccessResultWire;
+export const getCustomerEntitlementAccessResponseWire = entitlementAccessCheckResultWire;
 export const createCustomerEntitlementPathParamsWire = z.object({
     customerId: ulidWire,
 });
@@ -12476,6 +12500,18 @@ export const listCustomerEntitlementGrantsResponseWire = z.strictObject({
     data: z.array(entitlementGrantWire),
     meta: paginatedMetaWire,
 });
+export const getCustomerEntitlementValuePathParamsWire = z.object({
+    customerId: ulidWire,
+    entitlementId: ulidWire,
+});
+export const getCustomerEntitlementValueQueryParamsWire = z.object({
+    expand: z
+        .array(entitlementAccessExpandWire)
+        .optional()
+        .describe('Expand computed fields. Supported values are: - `value`: Expand the balance details of a metered entitlement; it sets the `value` field.'),
+    at: dateTimeWire.optional(),
+});
+export const getCustomerEntitlementValueResponseWire = entitlementValueResultWire;
 export const createCreditGrantPathParamsWire = z.object({
     customerId: ulidWire,
 });

package/dist/models/types.d.ts

@@ -628,15 +628,27 @@ export interface CreateCurrencyCustomRequest {
     thousandSeparator: string;
     code: string;
 }
-/** Balance details of a metered entitlement. */
+/**
+ * Balance details of a metered entitlement at the evaluation time, which is the
+ * `at` query parameter when given and the current time otherwise.
+ */
 export interface EntitlementAccessValue {
-    /** The remaining balance of the entitlement in the current usage period. */
+    /**
+     * The remaining balance of the entitlement in the usage period at the evaluation
+     * time.
+     */
     balance: string;
-    /** The usage recorded in the current usage period. */
+    /** The usage recorded in the usage period at the evaluation time. */
     usage: string;
-    /** The usage exceeding the available balance in the current usage period. */
+    /**
+     * The usage exceeding the available balance in the usage period at the evaluation
+     * time.
+     */
     overage: string;
-    /** The total amount granted and currently available to the entitlement. */
+    /**
+     * The total amount granted and available to the entitlement at the evaluation
+     * time.
+     */
     totalAvailableGrantAmount: string;
     /** The remaining balance of each grant, keyed by grant ID. */
     grantBalances: Record<string, string>;
@@ -1838,6 +1850,26 @@ export interface CustomerStripeCreateCustomerPortalSessionRequest {
     /** Options for configuring the Stripe Customer Portal Session. */
     stripeOptions: AppStripeCreateCustomerPortalSessionOptions;
 }
+/** Entitlement access check result. */
+export interface EntitlementAccessCheckResult {
+    /**
+     * Whether the customer has access to the feature. Always true for `boolean` and
+     * `static` entitlements. Depends on balance for `metered` entitlements.
+     */
+    hasAccess: boolean;
+    /**
+     * Only available for static entitlements. Config is the JSON parsable
+     * configuration of the entitlement. Useful to describe per customer configuration.
+     */
+    config?: string;
+    /**
+     * The type of the entitlement.
+     *
+     * If not provided, the feature has no entitlement defined (has access is always
+     * false in this case)
+     */
+    type?: 'metered' | 'static' | 'boolean';
+}
 /**
  * Recurring period input. The anchor is optional; the owning resource defines the
  * default, typically its creation time.
@@ -2497,8 +2529,8 @@ export interface CurrencyAmount {
     /** The fiat or custom currency code of the amount. */
     currency: BillingCurrencyCode;
 }
-/** Entitlement access result. */
-export interface EntitlementAccessResult {
+/** Entitlement value result. */
+export interface EntitlementValueResult {
     /** The type of the entitlement. */
     type: 'metered' | 'static' | 'boolean';
     /** The feature key of the entitlement. */
@@ -2514,8 +2546,8 @@ export interface EntitlementAccessResult {
      */
     config?: string;
     /**
-     * Only available for metered entitlements. The current balance details of the
-     * entitlement. Requires the `value` expand.
+     * Only available for metered entitlements. The balance details of the entitlement
+     * at the evaluation time. Requires the `value` expand.
      */
     value?: EntitlementAccessValue;
 }
@@ -4090,7 +4122,7 @@ export interface ChargeFlatFeeSystemIntent {
 /** List customer entitlement access response data. */
 export interface ListCustomerEntitlementAccessResponseData {
     /** The list of entitlement access results. */
-    data: EntitlementAccessResult[];
+    data: EntitlementValueResult[];
 }
 /**
  * Graduated tiered price.

package/dist/sdk/internal.d.ts

@@ -1,7 +1,7 @@
 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, 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 { GetCustomerEntitlementAccessRequest, GetCustomerEntitlementAccessResponse, ListEntitlementsRequest, ListEntitlementsResponse, GetEntitlementRequest, GetEntitlementResponse, GetCustomerEntitlementValueRequest, GetCustomerEntitlementValueResponse } 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';
 import type { ListInvoicesRequest, ListInvoicesResponse, GetInvoiceRequest, GetInvoiceResponse, UpdateInvoiceRequest, UpdateInvoiceResponse, DeleteInvoiceRequest, DeleteInvoiceResponse, AdvanceInvoiceRequest, AdvanceInvoiceResponse, ApproveInvoiceRequest, ApproveInvoiceResponse, RetryInvoiceRequest, RetryInvoiceResponse, SnapshotQuantitiesInvoiceRequest, SnapshotQuantitiesInvoiceResponse } from '../models/operations/invoices.js';
@@ -301,6 +301,15 @@ export declare class InternalEntitlements {
      * GET /openmeter/entitlements/{entitlementId}
      */
     get(request: GetEntitlementRequest, options?: RequestOptions): Promise<GetEntitlementResponse>;
+    /**
+     * Get customer entitlement value
+     *
+     * Get the customer's access through a single entitlement, optionally evaluated at
+     * a point in time.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/value
+     */
+    getCustomerValue(request: GetCustomerEntitlementValueRequest, options?: RequestOptions): Promise<GetCustomerEntitlementValueResponse>;
 }
 export declare class InternalSubscriptions {
     private readonly _client;

package/dist/sdk/internal.js

@@ -2,7 +2,7 @@
 import { unwrap } from '../lib/types.js';
 import { paginatePages } from '../lib/paginate.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 { getCustomerEntitlementAccess, listEntitlements, getEntitlement, getCustomerEntitlementValue, } from '../funcs/entitlements.js';
 import { unscheduleSubscription, restoreSubscription, migrateSubscription, createSubscriptionAddon, updateSubscriptionAddon, } from '../funcs/subscriptions.js';
 import { uninstallApp, updateApp, listAppCatalog, getAppCatalogItem, installApp, } from '../funcs/apps.js';
 import { listInvoices, getInvoice, updateInvoice, deleteInvoice, advanceInvoice, approveInvoice, retryInvoice, snapshotQuantitiesInvoice, } from '../funcs/invoices.js';
@@ -385,6 +385,17 @@ export class InternalEntitlements {
     async get(request, options) {
         return unwrap(await getEntitlement(this._client, request, options));
     }
+    /**
+     * Get customer entitlement value
+     *
+     * Get the customer's access through a single entitlement, optionally evaluated at
+     * a point in time.
+     *
+     * GET /openmeter/customers/{customerId}/entitlements/{entitlementId}/value
+     */
+    async getCustomerValue(request, options) {
+        return unwrap(await getCustomerEntitlementValue(this._client, request, options));
+    }
 }
 export class InternalSubscriptions {
     _client;

package/package.json

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