@commet/node 6.0.0 → 7.1.0

package/README.md

@@ -48,12 +48,12 @@ const commet = new Commet({
 // Create a customer
 const customer = await commet.customers.create({
   fullName: 'Acme Corp',
-  billingEmail: 'billing@acme.com'
+  email: 'billing@acme.com'
 });
 
 // Subscribe them to a plan
 await commet.subscriptions.create({
-  externalId: 'user_123',
+  customerId: 'cus_123',
   planCode: 'pro', // autocomplete works after `commet pull`
   billingInterval: 'yearly',
 });
@@ -86,14 +86,14 @@ const projects = await commet.quota.get({
 });
 
 // Check feature access
-const feature = await commet.features.get({
-  externalId: 'user_123',
+const access = await commet.featureAccess.canUse({
+  customerId: 'cus_123',
   code: 'api_calls'
 });
 
 // Generate customer portal link
 const portal = await commet.portal.getUrl({
-  externalId: 'user_123'
+  customerId: 'cus_123'
 });
 ```
 

package/dist/index.d.mts

@@ -820,6 +820,14 @@ interface Subscription {
         effectiveAt: string;
     } | null;
     cancelAtPeriodEnd: boolean;
+    scheduledPlanChange: {
+        changeType: "plan_downgrade" | "interval_change";
+        newPlanId: string | null;
+        newPlanName: string | null;
+        newBillingInterval: string | null;
+        /** @format date-time */
+        scheduledFor: string;
+    } | null;
     discount: {
         type: DiscountType;
         value: number;
@@ -949,6 +957,8 @@ declare class CommetHTTPClient {
      * Build full URL from endpoint and params
      */
     private buildURL;
+    private retryDelayMs;
+    private backoffDelayMs;
     private generateIdempotencyKey;
     /**
      * Sleep for specified milliseconds
@@ -957,7 +967,7 @@ declare class CommetHTTPClient {
 }
 
 interface ListActiveAddonsParams {
-    customerId?: string;
+    customerId: string;
 }
 interface ListAddonsParams {
     limit?: number;
@@ -991,7 +1001,7 @@ declare class AddonsResource {
     private httpClient;
     constructor(httpClient: CommetHTTPClient);
     /** List all active add-ons for a customer's subscription. */
-    listActive(params?: ListActiveAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<ActiveAddon>>>;
+    listActive(params: ListActiveAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<ActiveAddon>>>;
     /** List all add-ons with cursor-based pagination. */
     list(params?: ListAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<Addon>>>;
     /** Retrieve an add-on by its public ID or slug. */
@@ -1135,7 +1145,7 @@ declare class CustomersResource {
     createBatch(params: BatchCreateCustomersParams, options?: RequestOptions): Promise<ApiResponse<CustomerBatch>>;
 }
 
-interface ListFeaturesParams {
+interface ListFeatureAccessParams {
     customerId: string;
 }
 interface GetFeatureAccessParams {
@@ -1147,6 +1157,20 @@ interface CanUseFeatureParams {
     code: string;
     customerId: string;
 }
+declare class FeatureAccessResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    /** List all features for a customer's active subscription, scoped by the customerId query parameter. */
+    list(params: ListFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<Array<FeatureAccess>>>;
+    /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
+    get(params: GetFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+    /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
+    canUse(params: CanUseFeatureParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+}
+
+interface GetFeatureParams {
+    code: string;
+}
 interface CreateFeatureParams {
     name: string;
     code: string;
@@ -1166,12 +1190,10 @@ interface DeleteFeatureParams {
 declare class FeaturesResource {
     private httpClient;
     constructor(httpClient: CommetHTTPClient);
-    /** List all features for a customer's active subscription. */
-    list(params: ListFeaturesParams, options?: RequestOptions): Promise<ApiResponse<Array<FeatureAccess>>>;
-    /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
-    get(params: GetFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
-    /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
-    canUse(params: CanUseFeatureParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+    /** List every feature defined in the organization. This is the organization's feature catalog (definitions), not a customer's feature access. */
+    list(): Promise<ApiResponse<Array<Feature>>>;
+    /** Get a single feature definition by code from the organization's feature catalog. */
+    get(params: GetFeatureParams, options?: RequestOptions): Promise<ApiResponse<Feature>>;
     /** Create a new feature. Code must be lowercase alphanumeric with underscores. */
     create(params: CreateFeatureParams, options?: RequestOptions): Promise<ApiResponse<Feature>>;
     /** Update a feature's name, description, or unit name. At least one field must be provided. */
@@ -1798,6 +1820,7 @@ declare class GeneratedResources {
     apiKeys: ApiKeysResource;
     creditPacks: CreditPacksResource;
     customers: CustomersResource;
+    featureAccess: FeatureAccessResource;
     features: FeaturesResource;
     invoices: InvoicesResource;
     payouts: PayoutsResource;
@@ -2012,7 +2035,7 @@ declare function createCommet<const TConfig extends BillingConfig>(_billingConfi
 
 declare function registerIntegration(name: string, version: string): void;
 
-declare const API_VERSION = "2026-06-07";
+declare const API_VERSION = "2026-06-10";
 declare const SDK_VERSION: string;
 
-export { API_VERSION, type ActivateAddonParams, type ActiveAddon, type AddPayoutBankAccountParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddQuotaParams, type AddSeatsParams, type AddedPlanToGroup, type Addon, type AdjustBalanceParams, type AdvanceTestClockParams, type ApiErrorDetail, type ApiKey, type ApiResponse, type BalanceAdjustment, type BalanceTopup, type BatchCreateCustomersParams, type BillingConfig, type BillingInterval, type BulkSeatUpdate, type BulkSetSeatsParams, type CanUseFeatureParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CompletePayoutVerificationParams, type ConsumptionModel, type CreateAddonParams, type CreateAdjustmentInvoiceParams, type CreateApiKeyParams, type CreateCreditPackParams, type CreateCustomerParams, type CreateFeatureParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedApiKey, type CreatedInvoice, type CreditGrant, type CreditPack, type Currency, type Customer, type CustomerBatch, type CustomerID, type DeactivateAddonParams, type DefaultPlanPrice, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteWebhookParams, type DeletedObject, type DeletedPlanRegionalPricing, type DeletedSubscriptionAddon, type DiscountType, type DownloadInvoiceParams, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureLookup, type FeatureType, type GetActiveSubscriptionParams, type GetAddonParams, type GetAllQuotaAllowancesParams, type GetAllSeatBalancesParams, type GetCustomerParams, type GetFeatureAccessParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPlanParams, type GetPromoCodeParams, type GetQuotaAllowanceParams, type GetSeatBalanceParams, type GetSubscriptionParams, type GetTransactionParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type Invoice, type InvoiceDownload, type InvoiceStatus, type InvoiceType, type ListActiveAddonsParams, type ListAddonsParams, type ListApiKeysParams, type ListCustomersParams, type ListFeaturesParams, type ListInvoicesParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payout, type PayoutBankAccount, type PayoutVerification, type Plan, type PlanChange, type PlanDef, type PlanFeature, type PlanFeatureValue, type PlanGroup, type PlanPrice, type PlanRegionalPricing, type PlanRegionalPricingResult, type PlanVisibility, type PortalAccess, type PreviewChange, type PreviewChangePlanParams, type PriceDef, type PromoCode, type PurchaseCreditsParams, type RefundTransactionParams, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveQuotaParams, type RemoveSeatsParams, type RemovedPlanFeature, type RemovedPlanFromGroup, type ReorderPlansInGroupParams, type ReorderedPlans, type RequestOptions, type RequestPayoutParams, type RequestPortalAccessParams, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatBalanceListItem, type SeatEvent, type SendInvoiceParams, type SentInvoice, type SetDefaultPlanPriceParams, type SetPlanRegionalPricingParams, type SetPlanVisibilityParams, type SetQuotaParams, type SetSeatsParams, type Subscription, type SubscriptionAddon, type SubscriptionStatus, type TestClock, type TestClockBilling, type TestWebhookParams, type Timezone, type TopupBalanceParams, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type Transaction, type TransactionRefund, type TransactionRetry, type TransactionStatus, type UncancelSubscriptionParams, type UncanceledSubscription, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UpsertRegionalPricesParams, type UsageCheckDenialReason, type UsageCheckResult, type UsageEvent, type UsageEventProperty, type UsageQuota, type UsageQuotaEvent, type WebhookData, type WebhookEndpoint, type WebhookEndpointCreated, type WebhookEvent, type WebhookPayload, type WebhookTestResult, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };
+export { API_VERSION, type ActivateAddonParams, type ActiveAddon, type AddPayoutBankAccountParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddQuotaParams, type AddSeatsParams, type AddedPlanToGroup, type Addon, type AdjustBalanceParams, type AdvanceTestClockParams, type ApiErrorDetail, type ApiKey, type ApiResponse, type BalanceAdjustment, type BalanceTopup, type BatchCreateCustomersParams, type BillingConfig, type BillingInterval, type BulkSeatUpdate, type BulkSetSeatsParams, type CanUseFeatureParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CompletePayoutVerificationParams, type ConsumptionModel, type CreateAddonParams, type CreateAdjustmentInvoiceParams, type CreateApiKeyParams, type CreateCreditPackParams, type CreateCustomerParams, type CreateFeatureParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedApiKey, type CreatedInvoice, type CreditGrant, type CreditPack, type Currency, type Customer, type CustomerBatch, type CustomerID, type DeactivateAddonParams, type DefaultPlanPrice, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteWebhookParams, type DeletedObject, type DeletedPlanRegionalPricing, type DeletedSubscriptionAddon, type DiscountType, type DownloadInvoiceParams, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureLookup, type FeatureType, type GetActiveSubscriptionParams, type GetAddonParams, type GetAllQuotaAllowancesParams, type GetAllSeatBalancesParams, type GetCustomerParams, type GetFeatureAccessParams, type GetFeatureParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPlanParams, type GetPromoCodeParams, type GetQuotaAllowanceParams, type GetSeatBalanceParams, type GetSubscriptionParams, type GetTransactionParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type Invoice, type InvoiceDownload, type InvoiceStatus, type InvoiceType, type ListActiveAddonsParams, type ListAddonsParams, type ListApiKeysParams, type ListCustomersParams, type ListFeatureAccessParams, type ListInvoicesParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payout, type PayoutBankAccount, type PayoutVerification, type Plan, type PlanChange, type PlanDef, type PlanFeature, type PlanFeatureValue, type PlanGroup, type PlanPrice, type PlanRegionalPricing, type PlanRegionalPricingResult, type PlanVisibility, type PortalAccess, type PreviewChange, type PreviewChangePlanParams, type PriceDef, type PromoCode, type PurchaseCreditsParams, type RefundTransactionParams, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveQuotaParams, type RemoveSeatsParams, type RemovedPlanFeature, type RemovedPlanFromGroup, type ReorderPlansInGroupParams, type ReorderedPlans, type RequestOptions, type RequestPayoutParams, type RequestPortalAccessParams, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatBalanceListItem, type SeatEvent, type SendInvoiceParams, type SentInvoice, type SetDefaultPlanPriceParams, type SetPlanRegionalPricingParams, type SetPlanVisibilityParams, type SetQuotaParams, type SetSeatsParams, type Subscription, type SubscriptionAddon, type SubscriptionStatus, type TestClock, type TestClockBilling, type TestWebhookParams, type Timezone, type TopupBalanceParams, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type Transaction, type TransactionRefund, type TransactionRetry, type TransactionStatus, type UncancelSubscriptionParams, type UncanceledSubscription, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UpsertRegionalPricesParams, type UsageCheckDenialReason, type UsageCheckResult, type UsageEvent, type UsageEventProperty, type UsageQuota, type UsageQuotaEvent, type WebhookData, type WebhookEndpoint, type WebhookEndpointCreated, type WebhookEvent, type WebhookPayload, type WebhookTestResult, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };

package/dist/index.d.ts

@@ -820,6 +820,14 @@ interface Subscription {
         effectiveAt: string;
     } | null;
     cancelAtPeriodEnd: boolean;
+    scheduledPlanChange: {
+        changeType: "plan_downgrade" | "interval_change";
+        newPlanId: string | null;
+        newPlanName: string | null;
+        newBillingInterval: string | null;
+        /** @format date-time */
+        scheduledFor: string;
+    } | null;
     discount: {
         type: DiscountType;
         value: number;
@@ -949,6 +957,8 @@ declare class CommetHTTPClient {
      * Build full URL from endpoint and params
      */
     private buildURL;
+    private retryDelayMs;
+    private backoffDelayMs;
     private generateIdempotencyKey;
     /**
      * Sleep for specified milliseconds
@@ -957,7 +967,7 @@ declare class CommetHTTPClient {
 }
 
 interface ListActiveAddonsParams {
-    customerId?: string;
+    customerId: string;
 }
 interface ListAddonsParams {
     limit?: number;
@@ -991,7 +1001,7 @@ declare class AddonsResource {
     private httpClient;
     constructor(httpClient: CommetHTTPClient);
     /** List all active add-ons for a customer's subscription. */
-    listActive(params?: ListActiveAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<ActiveAddon>>>;
+    listActive(params: ListActiveAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<ActiveAddon>>>;
     /** List all add-ons with cursor-based pagination. */
     list(params?: ListAddonsParams, options?: RequestOptions): Promise<ApiResponse<Array<Addon>>>;
     /** Retrieve an add-on by its public ID or slug. */
@@ -1135,7 +1145,7 @@ declare class CustomersResource {
     createBatch(params: BatchCreateCustomersParams, options?: RequestOptions): Promise<ApiResponse<CustomerBatch>>;
 }
 
-interface ListFeaturesParams {
+interface ListFeatureAccessParams {
     customerId: string;
 }
 interface GetFeatureAccessParams {
@@ -1147,6 +1157,20 @@ interface CanUseFeatureParams {
     code: string;
     customerId: string;
 }
+declare class FeatureAccessResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    /** List all features for a customer's active subscription, scoped by the customerId query parameter. */
+    list(params: ListFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<Array<FeatureAccess>>>;
+    /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
+    get(params: GetFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+    /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
+    canUse(params: CanUseFeatureParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+}
+
+interface GetFeatureParams {
+    code: string;
+}
 interface CreateFeatureParams {
     name: string;
     code: string;
@@ -1166,12 +1190,10 @@ interface DeleteFeatureParams {
 declare class FeaturesResource {
     private httpClient;
     constructor(httpClient: CommetHTTPClient);
-    /** List all features for a customer's active subscription. */
-    list(params: ListFeaturesParams, options?: RequestOptions): Promise<ApiResponse<Array<FeatureAccess>>>;
-    /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
-    get(params: GetFeatureAccessParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
-    /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
-    canUse(params: CanUseFeatureParams, options?: RequestOptions): Promise<ApiResponse<FeatureLookup>>;
+    /** List every feature defined in the organization. This is the organization's feature catalog (definitions), not a customer's feature access. */
+    list(): Promise<ApiResponse<Array<Feature>>>;
+    /** Get a single feature definition by code from the organization's feature catalog. */
+    get(params: GetFeatureParams, options?: RequestOptions): Promise<ApiResponse<Feature>>;
     /** Create a new feature. Code must be lowercase alphanumeric with underscores. */
     create(params: CreateFeatureParams, options?: RequestOptions): Promise<ApiResponse<Feature>>;
     /** Update a feature's name, description, or unit name. At least one field must be provided. */
@@ -1798,6 +1820,7 @@ declare class GeneratedResources {
     apiKeys: ApiKeysResource;
     creditPacks: CreditPacksResource;
     customers: CustomersResource;
+    featureAccess: FeatureAccessResource;
     features: FeaturesResource;
     invoices: InvoicesResource;
     payouts: PayoutsResource;
@@ -2012,7 +2035,7 @@ declare function createCommet<const TConfig extends BillingConfig>(_billingConfi
 
 declare function registerIntegration(name: string, version: string): void;
 
-declare const API_VERSION = "2026-06-07";
+declare const API_VERSION = "2026-06-10";
 declare const SDK_VERSION: string;
 
-export { API_VERSION, type ActivateAddonParams, type ActiveAddon, type AddPayoutBankAccountParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddQuotaParams, type AddSeatsParams, type AddedPlanToGroup, type Addon, type AdjustBalanceParams, type AdvanceTestClockParams, type ApiErrorDetail, type ApiKey, type ApiResponse, type BalanceAdjustment, type BalanceTopup, type BatchCreateCustomersParams, type BillingConfig, type BillingInterval, type BulkSeatUpdate, type BulkSetSeatsParams, type CanUseFeatureParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CompletePayoutVerificationParams, type ConsumptionModel, type CreateAddonParams, type CreateAdjustmentInvoiceParams, type CreateApiKeyParams, type CreateCreditPackParams, type CreateCustomerParams, type CreateFeatureParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedApiKey, type CreatedInvoice, type CreditGrant, type CreditPack, type Currency, type Customer, type CustomerBatch, type CustomerID, type DeactivateAddonParams, type DefaultPlanPrice, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteWebhookParams, type DeletedObject, type DeletedPlanRegionalPricing, type DeletedSubscriptionAddon, type DiscountType, type DownloadInvoiceParams, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureLookup, type FeatureType, type GetActiveSubscriptionParams, type GetAddonParams, type GetAllQuotaAllowancesParams, type GetAllSeatBalancesParams, type GetCustomerParams, type GetFeatureAccessParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPlanParams, type GetPromoCodeParams, type GetQuotaAllowanceParams, type GetSeatBalanceParams, type GetSubscriptionParams, type GetTransactionParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type Invoice, type InvoiceDownload, type InvoiceStatus, type InvoiceType, type ListActiveAddonsParams, type ListAddonsParams, type ListApiKeysParams, type ListCustomersParams, type ListFeaturesParams, type ListInvoicesParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payout, type PayoutBankAccount, type PayoutVerification, type Plan, type PlanChange, type PlanDef, type PlanFeature, type PlanFeatureValue, type PlanGroup, type PlanPrice, type PlanRegionalPricing, type PlanRegionalPricingResult, type PlanVisibility, type PortalAccess, type PreviewChange, type PreviewChangePlanParams, type PriceDef, type PromoCode, type PurchaseCreditsParams, type RefundTransactionParams, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveQuotaParams, type RemoveSeatsParams, type RemovedPlanFeature, type RemovedPlanFromGroup, type ReorderPlansInGroupParams, type ReorderedPlans, type RequestOptions, type RequestPayoutParams, type RequestPortalAccessParams, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatBalanceListItem, type SeatEvent, type SendInvoiceParams, type SentInvoice, type SetDefaultPlanPriceParams, type SetPlanRegionalPricingParams, type SetPlanVisibilityParams, type SetQuotaParams, type SetSeatsParams, type Subscription, type SubscriptionAddon, type SubscriptionStatus, type TestClock, type TestClockBilling, type TestWebhookParams, type Timezone, type TopupBalanceParams, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type Transaction, type TransactionRefund, type TransactionRetry, type TransactionStatus, type UncancelSubscriptionParams, type UncanceledSubscription, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UpsertRegionalPricesParams, type UsageCheckDenialReason, type UsageCheckResult, type UsageEvent, type UsageEventProperty, type UsageQuota, type UsageQuotaEvent, type WebhookData, type WebhookEndpoint, type WebhookEndpointCreated, type WebhookEvent, type WebhookPayload, type WebhookTestResult, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };
+export { API_VERSION, type ActivateAddonParams, type ActiveAddon, type AddPayoutBankAccountParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddQuotaParams, type AddSeatsParams, type AddedPlanToGroup, type Addon, type AdjustBalanceParams, type AdvanceTestClockParams, type ApiErrorDetail, type ApiKey, type ApiResponse, type BalanceAdjustment, type BalanceTopup, type BatchCreateCustomersParams, type BillingConfig, type BillingInterval, type BulkSeatUpdate, type BulkSetSeatsParams, type CanUseFeatureParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CompletePayoutVerificationParams, type ConsumptionModel, type CreateAddonParams, type CreateAdjustmentInvoiceParams, type CreateApiKeyParams, type CreateCreditPackParams, type CreateCustomerParams, type CreateFeatureParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedApiKey, type CreatedInvoice, type CreditGrant, type CreditPack, type Currency, type Customer, type CustomerBatch, type CustomerID, type DeactivateAddonParams, type DefaultPlanPrice, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteWebhookParams, type DeletedObject, type DeletedPlanRegionalPricing, type DeletedSubscriptionAddon, type DiscountType, type DownloadInvoiceParams, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureLookup, type FeatureType, type GetActiveSubscriptionParams, type GetAddonParams, type GetAllQuotaAllowancesParams, type GetAllSeatBalancesParams, type GetCustomerParams, type GetFeatureAccessParams, type GetFeatureParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPlanParams, type GetPromoCodeParams, type GetQuotaAllowanceParams, type GetSeatBalanceParams, type GetSubscriptionParams, type GetTransactionParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type Invoice, type InvoiceDownload, type InvoiceStatus, type InvoiceType, type ListActiveAddonsParams, type ListAddonsParams, type ListApiKeysParams, type ListCustomersParams, type ListFeatureAccessParams, type ListInvoicesParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payout, type PayoutBankAccount, type PayoutVerification, type Plan, type PlanChange, type PlanDef, type PlanFeature, type PlanFeatureValue, type PlanGroup, type PlanPrice, type PlanRegionalPricing, type PlanRegionalPricingResult, type PlanVisibility, type PortalAccess, type PreviewChange, type PreviewChangePlanParams, type PriceDef, type PromoCode, type PurchaseCreditsParams, type RefundTransactionParams, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveQuotaParams, type RemoveSeatsParams, type RemovedPlanFeature, type RemovedPlanFromGroup, type ReorderPlansInGroupParams, type ReorderedPlans, type RequestOptions, type RequestPayoutParams, type RequestPortalAccessParams, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatBalanceListItem, type SeatEvent, type SendInvoiceParams, type SentInvoice, type SetDefaultPlanPriceParams, type SetPlanRegionalPricingParams, type SetPlanVisibilityParams, type SetQuotaParams, type SetSeatsParams, type Subscription, type SubscriptionAddon, type SubscriptionStatus, type TestClock, type TestClockBilling, type TestWebhookParams, type Timezone, type TopupBalanceParams, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type Transaction, type TransactionRefund, type TransactionRetry, type TransactionStatus, type UncancelSubscriptionParams, type UncanceledSubscription, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UpsertRegionalPricesParams, type UsageCheckDenialReason, type UsageCheckResult, type UsageEvent, type UsageEventProperty, type UsageQuota, type UsageQuotaEvent, type WebhookData, type WebhookEndpoint, type WebhookEndpointCreated, type WebhookEvent, type WebhookPayload, type WebhookTestResult, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };

package/dist/index.js

@@ -51,7 +51,7 @@ var AddonsResource = class {
   }
   /** List all active add-ons for a customer's subscription. */
   async listActive(params, options) {
-    return this.httpClient.get("/addons/active", params, options);
+    return this.httpClient.get("/active-addons", params, options);
   }
   /** List all add-ons with cursor-based pagination. */
   async list(params, options) {
@@ -152,29 +152,45 @@ var CustomersResource = class {
   }
 };
 
-// src/resources/features.ts
-var FeaturesResource = class {
+// src/resources/feature-access.ts
+var FeatureAccessResource = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /** List all features for a customer's active subscription. */
+  /** List all features for a customer's active subscription, scoped by the customerId query parameter. */
   async list(params, options) {
-    return this.httpClient.get("/features", params, options);
+    return this.httpClient.get("/feature-access", params, options);
   }
-  /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
+  /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
   async get(params, options) {
     const { code, ...rest } = params;
-    return this.httpClient.get(`/features/${code}`, rest, options);
+    return this.httpClient.get(`/feature-access/${code}`, rest, options);
   }
-  /** Get feature access details. Use action=canUse to check if customer can consume one more unit. */
+  /** Get feature access details for a customer. Use action=canUse to check if the customer can consume one more unit. */
   async canUse(params, options) {
     const { code, ...rest } = params;
     return this.httpClient.get(
-      `/features/${code}`,
+      `/feature-access/${code}`,
       { ...rest, action: "canUse" },
       options
     );
   }
+};
+
+// src/resources/features.ts
+var FeaturesResource = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /** List every feature defined in the organization. This is the organization's feature catalog (definitions), not a customer's feature access. */
+  async list() {
+    return this.httpClient.get("/features");
+  }
+  /** Get a single feature definition by code from the organization's feature catalog. */
+  async get(params, options) {
+    const { code } = params;
+    return this.httpClient.get(`/features/${code}`, void 0, options);
+  }
   /** Create a new feature. Code must be lowercase alphanumeric with underscores. */
   async create(params, options) {
     return this.httpClient.post("/features/manage", params, options);
@@ -646,6 +662,7 @@ var GeneratedResources = class {
     this.apiKeys = new ApiKeysResource(http);
     this.creditPacks = new CreditPacksResource(http);
     this.customers = new CustomersResource(http);
+    this.featureAccess = new FeatureAccessResource(http);
     this.features = new FeaturesResource(http);
     this.invoices = new InvoicesResource(http);
     this.payouts = new PayoutsResource(http);
@@ -792,8 +809,8 @@ var CommetValidationError = class extends CommetError {
 };
 
 // src/version.ts
-var API_VERSION = "2026-06-07";
-var SDK_VERSION = "6.0.0";
+var API_VERSION = "2026-06-10";
+var SDK_VERSION = "7.1.0";
 
 // src/utils/telemetry.ts
 var registeredIntegrations = /* @__PURE__ */ new Set();
@@ -877,6 +894,7 @@ var DEFAULT_RETRY_CONFIG = {
   // 8s
   retryableStatusCodes: [408, 429, 500, 502, 503, 504]
 };
+var RETRY_AFTER_CAP_MS = 3e4;
 var _CommetHTTPClient = class _CommetHTTPClient {
   constructor(config) {
     this.lastRequestMetrics = null;
@@ -988,17 +1006,16 @@ var _CommetHTTPClient = class _CommetHTTPClient {
       }
       if (!response.ok) {
         if (attempt <= this.retryConfig.maxRetries && this.retryConfig.retryableStatusCodes.includes(response.status)) {
-          const delay = Math.min(
-            this.retryConfig.baseDelay * 2 ** (attempt - 1),
-            this.retryConfig.maxDelay
-          );
-          if (this.config.debug) {
-            console.log(
-              `[Commet SDK] Retrying in ${delay}ms (attempt ${attempt}/${this.retryConfig.maxRetries})`
-            );
+          const delay = this.retryDelayMs(attempt, response);
+          if (delay !== null) {
+            if (this.config.debug) {
+              console.log(
+                `[Commet SDK] Retrying in ${delay}ms (attempt ${attempt}/${this.retryConfig.maxRetries})`
+              );
+            }
+            await this.sleep(delay);
+            return this.executeRequest(method, url, data, options, attempt + 1);
           }
-          await this.sleep(delay);
-          return this.executeRequest(method, url, data, options, attempt + 1);
         }
         if (this.config.debug) {
           console.log(
@@ -1048,10 +1065,7 @@ var _CommetHTTPClient = class _CommetHTTPClient {
       const isTimeoutErrorModern = typeof globalThis.DOMException !== "undefined" && error instanceof DOMException && error.name === "TimeoutError";
       if (isNetworkError || isTimeoutError || isTimeoutErrorModern) {
         if (attempt <= this.retryConfig.maxRetries) {
-          const delay = Math.min(
-            this.retryConfig.baseDelay * 2 ** (attempt - 1),
-            this.retryConfig.maxDelay
-          );
+          const delay = this.backoffDelayMs(attempt);
           if (this.config.debug) {
             console.log(`[Commet SDK] Network error, retrying in ${delay}ms`);
           }
@@ -1087,6 +1101,26 @@ var _CommetHTTPClient = class _CommetHTTPClient {
     }
     return finalUrl;
   }
+  // 429 retries wait exactly what the rate limiter reports in Retry-After
+  // (seconds until the window resets); a 429 without the header did not come
+  // from the rate limiter, so it is not retried (returns null). Exponential
+  // backoff only applies to statuses that carry no server-provided wait.
+  retryDelayMs(attempt, response) {
+    if (response.status === 429) {
+      const retryAfterSeconds = Number(response.headers.get("retry-after"));
+      if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) {
+        return Math.min(retryAfterSeconds * 1e3, RETRY_AFTER_CAP_MS);
+      }
+      return null;
+    }
+    return this.backoffDelayMs(attempt);
+  }
+  backoffDelayMs(attempt) {
+    return Math.min(
+      this.retryConfig.baseDelay * 2 ** (attempt - 1),
+      this.retryConfig.maxDelay
+    );
+  }
   generateIdempotencyKey() {
     return `commet-node-retry-${crypto.randomUUID()}`;
   }