@commet/node 7.1.0 → 7.2.0

package/dist/index.d.mts

@@ -140,7 +140,7 @@ type ResolvedPlanCode<TConfig> = [InferPlanCodes<TConfig>] extends [
 type SubscriptionStatus = "draft" | "pending_payment" | "trialing" | "active" | "past_due" | "canceled";
 type BillingInterval = "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
 type ConsumptionModel = "metered" | "credits" | "balance";
-type InvoiceType = "recurring" | "overage" | "plan_change" | "adjustment" | "credit_purchase" | "balance_topup" | "addon_activation";
+type InvoiceType = "recurring" | "overage" | "plan_change" | "adjustment" | "credit_purchase" | "balance_topup" | "addon_activation" | "one_time_payment";
 type TransactionStatus = "pending" | "succeeded" | "failed" | "refunded" | "disputed";
 type FeatureType = "boolean" | "usage" | "seats" | "quota";
 type DiscountType = "percentage" | "amount";
@@ -436,7 +436,7 @@ interface Invoice {
     /** @format date-time */
     updatedAt: string;
     lineItems?: Array<{
-        lineType: "plan_base" | "feature_overage" | "feature_seats" | "feature_quota" | "discount" | "promo_code_discount" | "credit" | "balance_overage" | "addon_base";
+        lineType: "plan_base" | "feature_overage" | "feature_seats" | "feature_quota" | "discount" | "promo_code_discount" | "credit" | "balance_overage" | "addon_base" | "one_time";
         featureName: string | null;
         description: string;
         quantity: number;
@@ -468,6 +468,32 @@ interface InvoiceStatus {
     object: "invoice";
     livemode: boolean;
 }
+interface Payment {
+    id: string;
+    customerId: string | null;
+    kind: "link" | "charge";
+    status: "pending" | "processing" | "succeeded" | "requires_action" | "failed" | "canceled";
+    provider: "stripe" | "commet";
+    amountSubtotal: number;
+    taxAmount: number;
+    amountTotal: number;
+    currency: string;
+    description: string;
+    metadata: Record<string, unknown> | null;
+    url: string | null;
+    expiresAt: string | null;
+    /** @format date-time */
+    createdAt: string;
+    /** @format date-time */
+    updatedAt: string;
+    object: "payment";
+    livemode: boolean;
+}
+interface PaymentMethodUpdateCheckout {
+    checkoutUrl: string;
+    object: "subscription";
+    livemode: boolean;
+}
 interface Payout {
     id: string;
     status: "pending" | "in_transit" | "paid" | "failed" | "canceled";
@@ -603,6 +629,15 @@ interface PlanChange {
         remainingCreditBalance: number;
     };
     invoiceId?: string;
+    seatLimitWarning?: {
+        featureCode: string;
+        featureName: string;
+        currentSeats: number;
+        included: number;
+        newPlanName: string;
+        /** @format date-time */
+        effectiveDate: string;
+    };
     object: "subscription";
     livemode: boolean;
 }
@@ -721,6 +756,18 @@ interface PromoCode {
     object: "promo_code";
     livemode: boolean;
 }
+interface ReactivatedSubscription {
+    id: string;
+    retryInitiated: boolean;
+    object: "subscription";
+    livemode: boolean;
+}
+interface RecoveryLink {
+    url: string;
+    token: string;
+    object: "subscription";
+    livemode: boolean;
+}
 interface RemovedPlanFeature {
     id: string;
     removed: true;
@@ -897,7 +944,6 @@ interface TransactionRefund {
 interface TransactionRetry {
     id: string;
     status: "processing";
-    retryInvoiceNumber: string;
     object: "transaction";
     livemode: boolean;
 }
@@ -1246,6 +1292,48 @@ declare class InvoicesResource {
     updateStatus(params: UpdateInvoiceStatusParams, options?: RequestOptions): Promise<ApiResponse<InvoiceStatus>>;
 }
 
+interface ListPaymentsParams {
+    customerId?: string;
+    /** @format date-time */
+    cursor?: string;
+    limit?: number;
+}
+interface CreatePaymentParams {
+    amount: number;
+    currency: string;
+    customerId?: string;
+    description: string;
+    successUrl?: string;
+    metadata?: Record<string, string>;
+}
+interface ChargePaymentParams {
+    customerId: string;
+    amount: number;
+    currency: string;
+    description: string;
+    metadata?: Record<string, string>;
+}
+interface GetPaymentParams {
+    id: string;
+}
+interface CancelPaymentParams {
+    id: string;
+}
+declare class PaymentsResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    /** List payments with cursor-based pagination. Filter by customer. */
+    list(params?: ListPaymentsParams, options?: RequestOptions): Promise<ApiResponse<Array<Payment>>>;
+    /** Create a hosted payment link. Returns a url the customer opens to pay with any card. Calculates tax, generates an invoice, and vaults the payment method on confirmation. No subscription or plan required. */
+    create(params: CreatePaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Charge a customer's vaulted payment method off-session. Calculates tax, generates an invoice, and sends a receipt. No subscription or plan required. */
+    charge(params: ChargePaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Retrieve a payment by its public ID. */
+    get(params: GetPaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Cancel a pending payment link so it can no longer be paid. Only a link that has not been paid or started processing can be canceled; canceling an already canceled link is a no-op. Charges cannot be canceled. */
+    cancel(params: CancelPaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+}
+
 interface AddPayoutBankAccountParams {
     accountNumber: string;
     accountHolderName: string;
@@ -1707,6 +1795,16 @@ interface CancelSubscriptionParams {
 interface UncancelSubscriptionParams {
     id: string;
 }
+interface ReactivateSubscriptionParams {
+    id: string;
+}
+interface CreateSubscriptionRecoveryLinkParams {
+    id: string;
+}
+interface UpdatePaymentMethodParams {
+    id: string;
+    successUrl?: string;
+}
 interface ChangePlanParams {
     id: string;
     newPlanId?: string;
@@ -1755,6 +1853,12 @@ declare class SubscriptionsResource {
     cancel(params: CancelSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<CanceledSubscription>>;
     /** Revert a scheduled cancellation. Only works when canceledAt is set but status is not yet 'canceled'. */
     uncancel(params: UncancelSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<UncanceledSubscription>>;
+    /** Retries the outstanding renewal charge for a past_due subscription. On a successful charge the subscription recovers to active and a payment.recovered webhook is delivered; a declined charge returns an error and the subscription stays past_due. */
+    reactivate(params: ReactivateSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<ReactivatedSubscription>>;
+    /** Generates a hosted, signed recovery link that lets the customer pay the outstanding renewal charge for a past_due subscription. Unlike reactivate, which charges server-to-server, this returns a link the merchant can deliver through their own email, SMS, or dashboard. The link carries a self-contained signed token and stays valid until the charge is paid or the subscription is no longer past due. */
+    createRecoveryLink(params: CreateSubscriptionRecoveryLinkParams, options?: RequestOptions): Promise<ApiResponse<RecoveryLink>>;
+    /** Creates a hosted checkout session for the customer to update the subscription's default payment method. */
+    updatePaymentMethod(params: UpdatePaymentMethodParams, options?: RequestOptions): Promise<ApiResponse<PaymentMethodUpdateCheckout>>;
     /** Upgrade, downgrade, or change billing interval. */
     changePlan(params: ChangePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanChange>>;
     /** Preview proration details for an immediate plan change (an upgrade or a longer interval) without applying it. Returns credit, charge, and net amount. Downgrades — a cheaper plan in the same group, or a shorter interval — are scheduled for the end of the current period instead of being prorated, so they return a 400 with code `plan_change_scheduled`; apply those via the change-plan endpoint. */
@@ -1811,7 +1915,7 @@ declare class TransactionsResource {
     get(params: GetTransactionParams, options?: RequestOptions): Promise<ApiResponse<Transaction>>;
     /** Issue a full refund for a payment transaction. */
     refund(params: RefundTransactionParams, options?: RequestOptions): Promise<ApiResponse<TransactionRefund>>;
-    /** Retry a failed payment transaction. Creates a new invoice and initiates a new payment attempt. */
+    /** Retry a failed subscription renewal. Re-charges the outstanding renewal invoice through the recovery engine. */
     retry(params: RetryTransactionParams, options?: RequestOptions): Promise<ApiResponse<TransactionRetry>>;
 }
 
@@ -1823,6 +1927,7 @@ declare class GeneratedResources {
     featureAccess: FeatureAccessResource;
     features: FeaturesResource;
     invoices: InvoicesResource;
+    payments: PaymentsResource;
     payouts: PayoutsResource;
     planGroups: PlanGroupsResource;
     plans: PlansResource;
@@ -2038,4 +2143,4 @@ declare function registerIntegration(name: string, version: string): void;
 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 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 };
+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 CancelPaymentParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type ChargePaymentParams, 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 CreatePaymentParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateSubscriptionRecoveryLinkParams, 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 GetPaymentParams, 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 ListPaymentsParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payment, type PaymentMethodUpdateCheckout, 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 ReactivateSubscriptionParams, type ReactivatedSubscription, type RecoveryLink, 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 UpdatePaymentMethodParams, 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

@@ -140,7 +140,7 @@ type ResolvedPlanCode<TConfig> = [InferPlanCodes<TConfig>] extends [
 type SubscriptionStatus = "draft" | "pending_payment" | "trialing" | "active" | "past_due" | "canceled";
 type BillingInterval = "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
 type ConsumptionModel = "metered" | "credits" | "balance";
-type InvoiceType = "recurring" | "overage" | "plan_change" | "adjustment" | "credit_purchase" | "balance_topup" | "addon_activation";
+type InvoiceType = "recurring" | "overage" | "plan_change" | "adjustment" | "credit_purchase" | "balance_topup" | "addon_activation" | "one_time_payment";
 type TransactionStatus = "pending" | "succeeded" | "failed" | "refunded" | "disputed";
 type FeatureType = "boolean" | "usage" | "seats" | "quota";
 type DiscountType = "percentage" | "amount";
@@ -436,7 +436,7 @@ interface Invoice {
     /** @format date-time */
     updatedAt: string;
     lineItems?: Array<{
-        lineType: "plan_base" | "feature_overage" | "feature_seats" | "feature_quota" | "discount" | "promo_code_discount" | "credit" | "balance_overage" | "addon_base";
+        lineType: "plan_base" | "feature_overage" | "feature_seats" | "feature_quota" | "discount" | "promo_code_discount" | "credit" | "balance_overage" | "addon_base" | "one_time";
         featureName: string | null;
         description: string;
         quantity: number;
@@ -468,6 +468,32 @@ interface InvoiceStatus {
     object: "invoice";
     livemode: boolean;
 }
+interface Payment {
+    id: string;
+    customerId: string | null;
+    kind: "link" | "charge";
+    status: "pending" | "processing" | "succeeded" | "requires_action" | "failed" | "canceled";
+    provider: "stripe" | "commet";
+    amountSubtotal: number;
+    taxAmount: number;
+    amountTotal: number;
+    currency: string;
+    description: string;
+    metadata: Record<string, unknown> | null;
+    url: string | null;
+    expiresAt: string | null;
+    /** @format date-time */
+    createdAt: string;
+    /** @format date-time */
+    updatedAt: string;
+    object: "payment";
+    livemode: boolean;
+}
+interface PaymentMethodUpdateCheckout {
+    checkoutUrl: string;
+    object: "subscription";
+    livemode: boolean;
+}
 interface Payout {
     id: string;
     status: "pending" | "in_transit" | "paid" | "failed" | "canceled";
@@ -603,6 +629,15 @@ interface PlanChange {
         remainingCreditBalance: number;
     };
     invoiceId?: string;
+    seatLimitWarning?: {
+        featureCode: string;
+        featureName: string;
+        currentSeats: number;
+        included: number;
+        newPlanName: string;
+        /** @format date-time */
+        effectiveDate: string;
+    };
     object: "subscription";
     livemode: boolean;
 }
@@ -721,6 +756,18 @@ interface PromoCode {
     object: "promo_code";
     livemode: boolean;
 }
+interface ReactivatedSubscription {
+    id: string;
+    retryInitiated: boolean;
+    object: "subscription";
+    livemode: boolean;
+}
+interface RecoveryLink {
+    url: string;
+    token: string;
+    object: "subscription";
+    livemode: boolean;
+}
 interface RemovedPlanFeature {
     id: string;
     removed: true;
@@ -897,7 +944,6 @@ interface TransactionRefund {
 interface TransactionRetry {
     id: string;
     status: "processing";
-    retryInvoiceNumber: string;
     object: "transaction";
     livemode: boolean;
 }
@@ -1246,6 +1292,48 @@ declare class InvoicesResource {
     updateStatus(params: UpdateInvoiceStatusParams, options?: RequestOptions): Promise<ApiResponse<InvoiceStatus>>;
 }
 
+interface ListPaymentsParams {
+    customerId?: string;
+    /** @format date-time */
+    cursor?: string;
+    limit?: number;
+}
+interface CreatePaymentParams {
+    amount: number;
+    currency: string;
+    customerId?: string;
+    description: string;
+    successUrl?: string;
+    metadata?: Record<string, string>;
+}
+interface ChargePaymentParams {
+    customerId: string;
+    amount: number;
+    currency: string;
+    description: string;
+    metadata?: Record<string, string>;
+}
+interface GetPaymentParams {
+    id: string;
+}
+interface CancelPaymentParams {
+    id: string;
+}
+declare class PaymentsResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    /** List payments with cursor-based pagination. Filter by customer. */
+    list(params?: ListPaymentsParams, options?: RequestOptions): Promise<ApiResponse<Array<Payment>>>;
+    /** Create a hosted payment link. Returns a url the customer opens to pay with any card. Calculates tax, generates an invoice, and vaults the payment method on confirmation. No subscription or plan required. */
+    create(params: CreatePaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Charge a customer's vaulted payment method off-session. Calculates tax, generates an invoice, and sends a receipt. No subscription or plan required. */
+    charge(params: ChargePaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Retrieve a payment by its public ID. */
+    get(params: GetPaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+    /** Cancel a pending payment link so it can no longer be paid. Only a link that has not been paid or started processing can be canceled; canceling an already canceled link is a no-op. Charges cannot be canceled. */
+    cancel(params: CancelPaymentParams, options?: RequestOptions): Promise<ApiResponse<Payment>>;
+}
+
 interface AddPayoutBankAccountParams {
     accountNumber: string;
     accountHolderName: string;
@@ -1707,6 +1795,16 @@ interface CancelSubscriptionParams {
 interface UncancelSubscriptionParams {
     id: string;
 }
+interface ReactivateSubscriptionParams {
+    id: string;
+}
+interface CreateSubscriptionRecoveryLinkParams {
+    id: string;
+}
+interface UpdatePaymentMethodParams {
+    id: string;
+    successUrl?: string;
+}
 interface ChangePlanParams {
     id: string;
     newPlanId?: string;
@@ -1755,6 +1853,12 @@ declare class SubscriptionsResource {
     cancel(params: CancelSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<CanceledSubscription>>;
     /** Revert a scheduled cancellation. Only works when canceledAt is set but status is not yet 'canceled'. */
     uncancel(params: UncancelSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<UncanceledSubscription>>;
+    /** Retries the outstanding renewal charge for a past_due subscription. On a successful charge the subscription recovers to active and a payment.recovered webhook is delivered; a declined charge returns an error and the subscription stays past_due. */
+    reactivate(params: ReactivateSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<ReactivatedSubscription>>;
+    /** Generates a hosted, signed recovery link that lets the customer pay the outstanding renewal charge for a past_due subscription. Unlike reactivate, which charges server-to-server, this returns a link the merchant can deliver through their own email, SMS, or dashboard. The link carries a self-contained signed token and stays valid until the charge is paid or the subscription is no longer past due. */
+    createRecoveryLink(params: CreateSubscriptionRecoveryLinkParams, options?: RequestOptions): Promise<ApiResponse<RecoveryLink>>;
+    /** Creates a hosted checkout session for the customer to update the subscription's default payment method. */
+    updatePaymentMethod(params: UpdatePaymentMethodParams, options?: RequestOptions): Promise<ApiResponse<PaymentMethodUpdateCheckout>>;
     /** Upgrade, downgrade, or change billing interval. */
     changePlan(params: ChangePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanChange>>;
     /** Preview proration details for an immediate plan change (an upgrade or a longer interval) without applying it. Returns credit, charge, and net amount. Downgrades — a cheaper plan in the same group, or a shorter interval — are scheduled for the end of the current period instead of being prorated, so they return a 400 with code `plan_change_scheduled`; apply those via the change-plan endpoint. */
@@ -1811,7 +1915,7 @@ declare class TransactionsResource {
     get(params: GetTransactionParams, options?: RequestOptions): Promise<ApiResponse<Transaction>>;
     /** Issue a full refund for a payment transaction. */
     refund(params: RefundTransactionParams, options?: RequestOptions): Promise<ApiResponse<TransactionRefund>>;
-    /** Retry a failed payment transaction. Creates a new invoice and initiates a new payment attempt. */
+    /** Retry a failed subscription renewal. Re-charges the outstanding renewal invoice through the recovery engine. */
     retry(params: RetryTransactionParams, options?: RequestOptions): Promise<ApiResponse<TransactionRetry>>;
 }
 
@@ -1823,6 +1927,7 @@ declare class GeneratedResources {
     featureAccess: FeatureAccessResource;
     features: FeaturesResource;
     invoices: InvoicesResource;
+    payments: PaymentsResource;
     payouts: PayoutsResource;
     planGroups: PlanGroupsResource;
     plans: PlansResource;
@@ -2038,4 +2143,4 @@ declare function registerIntegration(name: string, version: string): void;
 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 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 };
+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 CancelPaymentParams, type CancelSubscriptionParams, type CanceledSubscription, type ChangePlanParams, type ChargePaymentParams, 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 CreatePaymentParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateSubscriptionRecoveryLinkParams, 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 GetPaymentParams, 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 ListPaymentsParams, type ListPlanGroupsParams, type ListPlansParams, type ListPromoCodesParams, type ListSubscriptionsParams, type ListTransactionsParams, type ListWebhooksParams, type PaginatedList, type PaginatedResponse, type Payment, type PaymentMethodUpdateCheckout, 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 ReactivateSubscriptionParams, type ReactivatedSubscription, type RecoveryLink, 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 UpdatePaymentMethodParams, 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

@@ -246,6 +246,35 @@ var InvoicesResource = class {
   }
 };
 
+// src/resources/payments.ts
+var PaymentsResource = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /** List payments with cursor-based pagination. Filter by customer. */
+  async list(params, options) {
+    return this.httpClient.get("/payments", params, options);
+  }
+  /** Create a hosted payment link. Returns a url the customer opens to pay with any card. Calculates tax, generates an invoice, and vaults the payment method on confirmation. No subscription or plan required. */
+  async create(params, options) {
+    return this.httpClient.post("/payments", params, options);
+  }
+  /** Charge a customer's vaulted payment method off-session. Calculates tax, generates an invoice, and sends a receipt. No subscription or plan required. */
+  async charge(params, options) {
+    return this.httpClient.post("/payments/charge", params, options);
+  }
+  /** Retrieve a payment by its public ID. */
+  async get(params, options) {
+    const { id } = params;
+    return this.httpClient.get(`/payments/${id}`, void 0, options);
+  }
+  /** Cancel a pending payment link so it can no longer be paid. Only a link that has not been paid or started processing can be canceled; canceling an already canceled link is a no-op. Charges cannot be canceled. */
+  async cancel(params, options) {
+    const { id } = params;
+    return this.httpClient.post(`/payments/${id}/cancel`, {}, options);
+  }
+};
+
 // src/resources/payouts.ts
 var PayoutsResource = class {
   constructor(httpClient) {
@@ -553,6 +582,29 @@ var SubscriptionsResource = class {
     const { id } = params;
     return this.httpClient.post(`/subscriptions/${id}/uncancel`, {}, options);
   }
+  /** Retries the outstanding renewal charge for a past_due subscription. On a successful charge the subscription recovers to active and a payment.recovered webhook is delivered; a declined charge returns an error and the subscription stays past_due. */
+  async reactivate(params, options) {
+    const { id } = params;
+    return this.httpClient.post(`/subscriptions/${id}/reactivate`, {}, options);
+  }
+  /** Generates a hosted, signed recovery link that lets the customer pay the outstanding renewal charge for a past_due subscription. Unlike reactivate, which charges server-to-server, this returns a link the merchant can deliver through their own email, SMS, or dashboard. The link carries a self-contained signed token and stays valid until the charge is paid or the subscription is no longer past due. */
+  async createRecoveryLink(params, options) {
+    const { id } = params;
+    return this.httpClient.post(
+      `/subscriptions/${id}/recovery-link`,
+      {},
+      options
+    );
+  }
+  /** Creates a hosted checkout session for the customer to update the subscription's default payment method. */
+  async updatePaymentMethod(params, options) {
+    const { id, ...rest } = params;
+    return this.httpClient.post(
+      `/subscriptions/${id}/payment-method/update`,
+      rest,
+      options
+    );
+  }
   /** Upgrade, downgrade, or change billing interval. */
   async changePlan(params, options) {
     const { id, ...rest } = params;
@@ -648,7 +700,7 @@ var TransactionsResource = class {
     const { id } = params;
     return this.httpClient.post(`/transactions/${id}/refund`, {}, options);
   }
-  /** Retry a failed payment transaction. Creates a new invoice and initiates a new payment attempt. */
+  /** Retry a failed subscription renewal. Re-charges the outstanding renewal invoice through the recovery engine. */
   async retry(params, options) {
     const { id } = params;
     return this.httpClient.post(`/transactions/${id}/retry`, {}, options);
@@ -665,6 +717,7 @@ var GeneratedResources = class {
     this.featureAccess = new FeatureAccessResource(http);
     this.features = new FeaturesResource(http);
     this.invoices = new InvoicesResource(http);
+    this.payments = new PaymentsResource(http);
     this.payouts = new PayoutsResource(http);
     this.planGroups = new PlanGroupsResource(http);
     this.plans = new PlansResource(http);
@@ -810,7 +863,7 @@ var CommetValidationError = class extends CommetError {
 
 // src/version.ts
 var API_VERSION = "2026-06-10";
-var SDK_VERSION = "7.1.0";
+var SDK_VERSION = "7.2.0";
 
 // src/utils/telemetry.ts
 var registeredIntegrations = /* @__PURE__ */ new Set();