@commet/node 5.1.0 → 5.3.0

package/dist/index.d.ts

@@ -441,6 +441,282 @@ declare class CustomersResource {
     list(params?: ListCustomersParams): Promise<ApiResponse<Customer[]>>;
 }
 
+type PlanID = `plan_${string}`;
+type BillingInterval = "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
+type FeatureType = "boolean" | "usage" | "seats" | "quota";
+interface PlanPrice {
+    billingInterval: BillingInterval;
+    price: number;
+    isDefault: boolean;
+    trialDays: number;
+}
+interface PlanFeature {
+    code: string;
+    name: string;
+    type: FeatureType;
+    unitName: string | null;
+    enabled?: boolean;
+    includedAmount?: number;
+    unlimited?: boolean;
+    overageEnabled?: boolean;
+    overageUnitPrice?: number;
+}
+interface Plan {
+    id: PlanID;
+    object: "plan";
+    livemode: boolean;
+    code: string;
+    name: string;
+    description: string | null;
+    isPublic: boolean;
+    isFree: boolean;
+    isDefault: boolean;
+    sortOrder: number;
+    prices: PlanPrice[];
+    features: PlanFeature[];
+    createdAt: string;
+}
+interface PlanDetailPrice {
+    billingInterval: BillingInterval;
+    price: number;
+    isDefault: boolean;
+    trialDays: number;
+    introOffer: {
+        enabled: boolean;
+        discountType: "percentage" | "amount" | null;
+        discountValue: number | null;
+        durationCycles: number | null;
+    } | null;
+}
+interface PlanDetailFeature extends PlanFeature {
+    overage: {
+        enabled: boolean;
+        model: "per_unit" | null;
+        unitPrice: number | null;
+    } | null;
+}
+interface PlanDetail {
+    id: PlanID;
+    object: "plan";
+    livemode: boolean;
+    code: string;
+    name: string;
+    description: string | null;
+    isPublic: boolean;
+    isDefault: boolean;
+    sortOrder: number;
+    prices: PlanDetailPrice[];
+    features: PlanDetailFeature[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListPlansParams extends ListParams {
+    includePrivate?: boolean;
+}
+interface PlanManage {
+    id: string;
+    object: "plan";
+    livemode: boolean;
+    name: string;
+    code: string;
+    description: string | null;
+    consumptionModel: string | null;
+    isPublic: boolean;
+    isDefault: boolean;
+    isFree: boolean;
+    blockOnExhaustion: boolean;
+    sortOrder: number;
+    planGroupId: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PlanFeatureManageBase {
+    planId: string;
+    featureId: string;
+    enabled: boolean;
+    includedAmount: number | null;
+    unlimited: boolean;
+    overageEnabled: boolean;
+    creditsPerUnit: number | null;
+}
+interface FixedPricingFeatureManage extends PlanFeatureManageBase {
+    pricingMode: "fixed";
+    overageUnitPrice: number | null;
+    margin: null;
+}
+interface AiModelPricingFeatureManage extends PlanFeatureManageBase {
+    pricingMode: "ai_model";
+    margin: number;
+    overageUnitPrice: null;
+}
+type PlanFeatureManage = FixedPricingFeatureManage | AiModelPricingFeatureManage;
+interface PlanPriceManage {
+    id: string;
+    object: "plan_price";
+    livemode: boolean;
+    planId: string;
+    billingInterval: BillingInterval;
+    price: number;
+    isDefault: boolean;
+    trialDays: number;
+    includedBalance: number | null;
+    includedCredits: number | null;
+    introOfferEnabled: boolean;
+    introOfferDiscountType: "percentage" | "amount" | null;
+    introOfferDiscountValue: number | null;
+    introOfferDurationCycles: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface RegionalPriceResult {
+    priceId: string;
+    overrides: Array<{
+        currency: string;
+        price: number;
+    }>;
+}
+interface DeleteResult {
+    id: string;
+    deleted: true;
+}
+interface RemoveResult {
+    id: string;
+    removed: true;
+}
+interface CreatePlanParams {
+    name: string;
+    code: string;
+    description?: string;
+    consumptionModel?: "metered" | "credits" | "balance";
+    isPublic?: boolean;
+    isFree?: boolean;
+    blockOnExhaustion?: boolean;
+    planGroupId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpdatePlanParams {
+    id: string;
+    name?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    isPublic?: boolean;
+}
+interface DeletePlanParams {
+    id: string;
+}
+interface SetVisibilityParams {
+    id: string;
+    isPublic: boolean;
+}
+interface AddPlanFeatureBase {
+    planId: string;
+    featureId: string;
+    enabled?: boolean;
+    includedAmount?: number;
+    unlimited?: boolean;
+    overageEnabled?: boolean;
+    creditsPerUnit?: number | null;
+}
+interface AddFixedPricingFeatureParams extends AddPlanFeatureBase {
+    pricingMode?: "fixed";
+    overageUnitPrice?: number;
+}
+interface AddAiModelPricingFeatureParams extends AddPlanFeatureBase {
+    pricingMode: "ai_model";
+    margin: number;
+}
+type AddPlanFeatureParams = AddFixedPricingFeatureParams | AddAiModelPricingFeatureParams;
+interface UpdatePlanFeatureBase {
+    planId: string;
+    featureId: string;
+    enabled?: boolean;
+    includedAmount?: number;
+    unlimited?: boolean;
+    overageEnabled?: boolean;
+    creditsPerUnit?: number | null;
+}
+interface UpdateFixedPricingFeatureParams extends UpdatePlanFeatureBase {
+    pricingMode?: "fixed";
+    overageUnitPrice?: number;
+}
+interface UpdateAiModelPricingFeatureParams extends UpdatePlanFeatureBase {
+    pricingMode: "ai_model";
+    margin?: number;
+}
+type UpdatePlanFeatureParams = UpdateFixedPricingFeatureParams | UpdateAiModelPricingFeatureParams;
+interface RemovePlanFeatureParams {
+    planId: string;
+    featureId: string;
+}
+interface AddPlanPriceParams {
+    planId: string;
+    billingInterval: BillingInterval;
+    price: number;
+    trialDays?: number;
+    isDefault?: boolean;
+    includedBalance?: number;
+    includedCredits?: number;
+    introOfferEnabled?: boolean;
+    introOfferDiscountType?: "percentage" | "amount";
+    introOfferDiscountValue?: number;
+    introOfferDurationCycles?: number;
+}
+interface UpdatePlanPriceParams {
+    planId: string;
+    priceId: string;
+    price?: number;
+    isDefault?: boolean;
+    trialDays?: number;
+    includedBalance?: number;
+    includedCredits?: number;
+    introOfferEnabled?: boolean;
+    introOfferDiscountType?: "percentage" | "amount" | null;
+    introOfferDiscountValue?: number | null;
+    introOfferDurationCycles?: number | null;
+}
+interface DeletePlanPriceParams {
+    planId: string;
+    priceId: string;
+}
+interface SetDefaultPriceParams {
+    planId: string;
+    priceId: string;
+}
+interface SetRegionalPricesParams {
+    planId: string;
+    priceId: string;
+    overrides: Array<{
+        currency: string;
+        price: number;
+    }>;
+}
+interface DeleteRegionalPricesParams {
+    planId: string;
+    priceId: string;
+}
+declare class PlansResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    list(params?: ListPlansParams): Promise<ApiResponse<Plan[]>>;
+    get(params: {
+        id: string;
+    }): Promise<ApiResponse<PlanDetail>>;
+    create(params: CreatePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
+    update(params: UpdatePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
+    delete(params: DeletePlanParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
+    setVisibility(params: SetVisibilityParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
+    addFeature(params: AddPlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<PlanFeatureManage>>;
+    updateFeature(params: UpdatePlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<PlanFeatureManage>>;
+    removeFeature(params: RemovePlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<RemoveResult>>;
+    addPrice(params: AddPlanPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
+    updatePrice(params: UpdatePlanPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
+    deletePrice(params: DeletePlanPriceParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
+    setDefaultPrice(params: SetDefaultPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
+    setRegionalPrices(params: SetRegionalPricesParams, options?: RequestOptions): Promise<ApiResponse<RegionalPriceResult>>;
+    deleteRegionalPrices(params: DeleteRegionalPricesParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
+}
+
 interface GetFeatureParams {
     customerId: CustomerID;
     code: string;
@@ -457,7 +733,7 @@ interface FeatureAccess {
     livemode: boolean;
     code: string;
     name: string;
-    type: "boolean" | "usage" | "seats";
+    type: FeatureType;
     allowed: boolean;
     enabled?: boolean;
     current?: number;
@@ -465,6 +741,7 @@ interface FeatureAccess {
     remaining?: number;
     overage?: number;
     overageUnitPrice?: number;
+    billedQuantity?: number;
     unlimited?: boolean;
     overageEnabled?: boolean;
 }
@@ -479,7 +756,7 @@ interface Feature {
     livemode: boolean;
     name: string;
     code: string;
-    type: "boolean" | "usage" | "seats";
+    type: FeatureType;
     description: string | null;
     unitName: string | null;
     createdAt: string;
@@ -488,7 +765,7 @@ interface Feature {
 interface CreateFeatureParams {
     code: string;
     name: string;
-    type: "boolean" | "usage" | "seats";
+    type: FeatureType;
     description?: string;
     unitName?: string;
 }
@@ -613,367 +890,91 @@ interface CreateAdjustmentParams {
 interface GetDownloadUrlParams {
     id: string;
 }
-interface SendInvoiceParams {
-    id: string;
-}
-interface UpdateInvoiceStatusParams {
-    id: string;
-    status: string;
-}
-declare class InvoicesResource {
-    private httpClient;
-    constructor(httpClient: CommetHTTPClient);
-    list(params?: ListInvoicesParams): Promise<ApiResponse<InvoiceListItem[]>>;
-    get(params: GetInvoiceParams): Promise<ApiResponse<InvoiceDetail>>;
-    /** Negative amount creates a credit. */
-    createAdjustment(params: CreateAdjustmentParams, options?: RequestOptions): Promise<ApiResponse<CreateAdjustmentResult>>;
-    /** Signed URL, expires after 7 days. */
-    getDownloadUrl(params: GetDownloadUrlParams): Promise<ApiResponse<InvoiceDownloadResult>>;
-    send(params: SendInvoiceParams, options?: RequestOptions): Promise<ApiResponse<InvoiceSendResult>>;
-    /** Only outstanding invoices can be changed to paid or void. */
-    updateStatus(params: UpdateInvoiceStatusParams, options?: RequestOptions): Promise<ApiResponse<InvoiceStatusResult>>;
-}
-
-interface PlanGroup {
-    id: string;
-    object: "plan_group";
-    livemode: boolean;
-    name: string;
-    description: string | null;
-    isPublic: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-interface PlanGroupDetail extends PlanGroup {
-    plans: Array<{
-        id: string;
-        code: string;
-        name: string;
-        sortOrder: number;
-    }>;
-}
-interface ListPlanGroupsParams {
-    limit?: number;
-    cursor?: string;
-}
-interface GetPlanGroupParams {
-    id: string;
-}
-interface CreatePlanGroupParams {
-    name: string;
-    description?: string;
-    isPublic?: boolean;
-}
-interface UpdatePlanGroupParams {
-    id: string;
-    name?: string;
-    description?: string;
-    isPublic?: boolean;
-}
-interface DeletePlanGroupParams {
-    id: string;
-}
-interface AddPlanToGroupParams {
-    id: string;
-    planId: string;
-    sortOrder?: number;
-}
-interface RemovePlanFromGroupParams {
-    id: string;
-    planId: string;
-}
-interface ReorderPlansParams {
-    id: string;
-    planIds: string[];
-}
-declare class PlanGroupsResource {
-    private httpClient;
-    constructor(httpClient: CommetHTTPClient);
-    list(params?: ListPlanGroupsParams): Promise<ApiResponse<PlanGroup[]>>;
-    get(params: GetPlanGroupParams): Promise<ApiResponse<PlanGroupDetail>>;
-    create(params: CreatePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroup>>;
-    update(params: UpdatePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroup>>;
-    /** Plans in the group are unlinked, not deleted. */
-    delete(params: DeletePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<void>>;
-    addPlan(params: AddPlanToGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroupDetail>>;
-    removePlan(params: RemovePlanFromGroupParams, options?: RequestOptions): Promise<ApiResponse<void>>;
-    reorderPlans(params: ReorderPlansParams, options?: RequestOptions): Promise<ApiResponse<PlanGroupDetail>>;
-}
-
-type PlanID = `plan_${string}`;
-type BillingInterval = "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
-type FeatureType = "boolean" | "usage" | "seats";
-interface PlanPrice {
-    billingInterval: BillingInterval;
-    price: number;
-    isDefault: boolean;
-    trialDays: number;
-}
-interface PlanFeature {
-    code: string;
-    name: string;
-    type: FeatureType;
-    unitName: string | null;
-    enabled?: boolean;
-    includedAmount?: number;
-    unlimited?: boolean;
-    overageEnabled?: boolean;
-    overageUnitPrice?: number;
-}
-interface Plan {
-    id: PlanID;
-    object: "plan";
-    livemode: boolean;
-    code: string;
-    name: string;
-    description: string | null;
-    isPublic: boolean;
-    isFree: boolean;
-    isDefault: boolean;
-    sortOrder: number;
-    prices: PlanPrice[];
-    features: PlanFeature[];
-    createdAt: string;
-}
-interface PlanDetailPrice {
-    billingInterval: BillingInterval;
-    price: number;
-    isDefault: boolean;
-    trialDays: number;
-    introOffer: {
-        enabled: boolean;
-        discountType: "percentage" | "amount" | null;
-        discountValue: number | null;
-        durationCycles: number | null;
-    } | null;
-}
-interface PlanDetailFeature extends PlanFeature {
-    overage: {
-        enabled: boolean;
-        model: "per_unit" | null;
-        unitPrice: number | null;
-    } | null;
-}
-interface PlanDetail {
-    id: PlanID;
-    object: "plan";
-    livemode: boolean;
-    code: string;
-    name: string;
-    description: string | null;
-    isPublic: boolean;
-    isDefault: boolean;
-    sortOrder: number;
-    prices: PlanDetailPrice[];
-    features: PlanDetailFeature[];
-    createdAt: string;
-    updatedAt: string;
-}
-interface ListPlansParams extends ListParams {
-    includePrivate?: boolean;
-}
-interface PlanManage {
-    id: string;
-    object: "plan";
-    livemode: boolean;
-    name: string;
-    code: string;
-    description: string | null;
-    consumptionModel: string | null;
-    isPublic: boolean;
-    isDefault: boolean;
-    isFree: boolean;
-    blockOnExhaustion: boolean;
-    sortOrder: number;
-    planGroupId: string | null;
-    metadata: Record<string, unknown> | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface PlanFeatureManageBase {
-    planId: string;
-    featureId: string;
-    enabled: boolean;
-    includedAmount: number | null;
-    unlimited: boolean;
-    overageEnabled: boolean;
-    creditsPerUnit: number | null;
+interface SendInvoiceParams {
+    id: string;
 }
-interface FixedPricingFeatureManage extends PlanFeatureManageBase {
-    pricingMode: "fixed";
-    overageUnitPrice: number | null;
-    margin: null;
+interface UpdateInvoiceStatusParams {
+    id: string;
+    status: string;
 }
-interface AiModelPricingFeatureManage extends PlanFeatureManageBase {
-    pricingMode: "ai_model";
-    margin: number;
-    overageUnitPrice: null;
+declare class InvoicesResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    list(params?: ListInvoicesParams): Promise<ApiResponse<InvoiceListItem[]>>;
+    get(params: GetInvoiceParams): Promise<ApiResponse<InvoiceDetail>>;
+    /** Negative amount creates a credit. */
+    createAdjustment(params: CreateAdjustmentParams, options?: RequestOptions): Promise<ApiResponse<CreateAdjustmentResult>>;
+    /** Signed URL, expires after 7 days. */
+    getDownloadUrl(params: GetDownloadUrlParams): Promise<ApiResponse<InvoiceDownloadResult>>;
+    send(params: SendInvoiceParams, options?: RequestOptions): Promise<ApiResponse<InvoiceSendResult>>;
+    /** Only outstanding invoices can be changed to paid or void. */
+    updateStatus(params: UpdateInvoiceStatusParams, options?: RequestOptions): Promise<ApiResponse<InvoiceStatusResult>>;
 }
-type PlanFeatureManage = FixedPricingFeatureManage | AiModelPricingFeatureManage;
-interface PlanPriceManage {
+
+interface PlanGroup {
     id: string;
-    object: "plan_price";
+    object: "plan_group";
     livemode: boolean;
-    planId: string;
-    billingInterval: BillingInterval;
-    price: number;
-    isDefault: boolean;
-    trialDays: number;
-    includedBalance: number | null;
-    includedCredits: number | null;
-    introOfferEnabled: boolean;
-    introOfferDiscountType: "percentage" | "amount" | null;
-    introOfferDiscountValue: number | null;
-    introOfferDurationCycles: number | null;
+    name: string;
+    description: string | null;
+    isPublic: boolean;
     createdAt: string;
     updatedAt: string;
 }
-interface RegionalPriceResult {
-    priceId: string;
-    overrides: Array<{
-        currency: string;
-        price: number;
+interface PlanGroupDetail extends PlanGroup {
+    plans: Array<{
+        id: string;
+        code: string;
+        name: string;
+        sortOrder: number;
     }>;
 }
-interface DeleteResult {
-    id: string;
-    deleted: true;
+interface ListPlanGroupsParams {
+    limit?: number;
+    cursor?: string;
 }
-interface RemoveResult {
+interface GetPlanGroupParams {
     id: string;
-    removed: true;
 }
-interface CreatePlanParams {
+interface CreatePlanGroupParams {
     name: string;
-    code: string;
     description?: string;
-    consumptionModel?: "metered" | "credits" | "balance";
     isPublic?: boolean;
-    isFree?: boolean;
-    blockOnExhaustion?: boolean;
-    planGroupId?: string;
-    metadata?: Record<string, unknown>;
 }
-interface UpdatePlanParams {
+interface UpdatePlanGroupParams {
     id: string;
     name?: string;
     description?: string;
-    metadata?: Record<string, unknown>;
     isPublic?: boolean;
 }
-interface DeletePlanParams {
+interface DeletePlanGroupParams {
     id: string;
 }
-interface SetVisibilityParams {
+interface AddPlanToGroupParams {
     id: string;
-    isPublic: boolean;
-}
-interface AddPlanFeatureBase {
-    planId: string;
-    featureId: string;
-    enabled?: boolean;
-    includedAmount?: number;
-    unlimited?: boolean;
-    overageEnabled?: boolean;
-    creditsPerUnit?: number | null;
-}
-interface AddFixedPricingFeatureParams extends AddPlanFeatureBase {
-    pricingMode?: "fixed";
-    overageUnitPrice?: number;
-}
-interface AddAiModelPricingFeatureParams extends AddPlanFeatureBase {
-    pricingMode: "ai_model";
-    margin: number;
-}
-type AddPlanFeatureParams = AddFixedPricingFeatureParams | AddAiModelPricingFeatureParams;
-interface UpdatePlanFeatureBase {
-    planId: string;
-    featureId: string;
-    enabled?: boolean;
-    includedAmount?: number;
-    unlimited?: boolean;
-    overageEnabled?: boolean;
-    creditsPerUnit?: number | null;
-}
-interface UpdateFixedPricingFeatureParams extends UpdatePlanFeatureBase {
-    pricingMode?: "fixed";
-    overageUnitPrice?: number;
-}
-interface UpdateAiModelPricingFeatureParams extends UpdatePlanFeatureBase {
-    pricingMode: "ai_model";
-    margin?: number;
-}
-type UpdatePlanFeatureParams = UpdateFixedPricingFeatureParams | UpdateAiModelPricingFeatureParams;
-interface RemovePlanFeatureParams {
-    planId: string;
-    featureId: string;
-}
-interface AddPlanPriceParams {
-    planId: string;
-    billingInterval: BillingInterval;
-    price: number;
-    trialDays?: number;
-    isDefault?: boolean;
-    includedBalance?: number;
-    includedCredits?: number;
-    introOfferEnabled?: boolean;
-    introOfferDiscountType?: "percentage" | "amount";
-    introOfferDiscountValue?: number;
-    introOfferDurationCycles?: number;
-}
-interface UpdatePlanPriceParams {
-    planId: string;
-    priceId: string;
-    price?: number;
-    isDefault?: boolean;
-    trialDays?: number;
-    includedBalance?: number;
-    includedCredits?: number;
-    introOfferEnabled?: boolean;
-    introOfferDiscountType?: "percentage" | "amount" | null;
-    introOfferDiscountValue?: number | null;
-    introOfferDurationCycles?: number | null;
-}
-interface DeletePlanPriceParams {
-    planId: string;
-    priceId: string;
-}
-interface SetDefaultPriceParams {
     planId: string;
-    priceId: string;
+    sortOrder?: number;
 }
-interface SetRegionalPricesParams {
+interface RemovePlanFromGroupParams {
+    id: string;
     planId: string;
-    priceId: string;
-    overrides: Array<{
-        currency: string;
-        price: number;
-    }>;
 }
-interface DeleteRegionalPricesParams {
-    planId: string;
-    priceId: string;
+interface ReorderPlansParams {
+    id: string;
+    planIds: string[];
 }
-declare class PlansResource {
+declare class PlanGroupsResource {
     private httpClient;
     constructor(httpClient: CommetHTTPClient);
-    list(params?: ListPlansParams): Promise<ApiResponse<Plan[]>>;
-    get(params: {
-        id: string;
-    }): Promise<ApiResponse<PlanDetail>>;
-    create(params: CreatePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
-    update(params: UpdatePlanParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
-    delete(params: DeletePlanParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
-    setVisibility(params: SetVisibilityParams, options?: RequestOptions): Promise<ApiResponse<PlanManage>>;
-    addFeature(params: AddPlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<PlanFeatureManage>>;
-    updateFeature(params: UpdatePlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<PlanFeatureManage>>;
-    removeFeature(params: RemovePlanFeatureParams, options?: RequestOptions): Promise<ApiResponse<RemoveResult>>;
-    addPrice(params: AddPlanPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
-    updatePrice(params: UpdatePlanPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
-    deletePrice(params: DeletePlanPriceParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
-    setDefaultPrice(params: SetDefaultPriceParams, options?: RequestOptions): Promise<ApiResponse<PlanPriceManage>>;
-    setRegionalPrices(params: SetRegionalPricesParams, options?: RequestOptions): Promise<ApiResponse<RegionalPriceResult>>;
-    deleteRegionalPrices(params: DeleteRegionalPricesParams, options?: RequestOptions): Promise<ApiResponse<DeleteResult>>;
+    list(params?: ListPlanGroupsParams): Promise<ApiResponse<PlanGroup[]>>;
+    get(params: GetPlanGroupParams): Promise<ApiResponse<PlanGroupDetail>>;
+    create(params: CreatePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroup>>;
+    update(params: UpdatePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroup>>;
+    /** Plans in the group are unlinked, not deleted. */
+    delete(params: DeletePlanGroupParams, options?: RequestOptions): Promise<ApiResponse<void>>;
+    addPlan(params: AddPlanToGroupParams, options?: RequestOptions): Promise<ApiResponse<PlanGroupDetail>>;
+    removePlan(params: RemovePlanFromGroupParams, options?: RequestOptions): Promise<ApiResponse<void>>;
+    reorderPlans(params: ReorderPlansParams, options?: RequestOptions): Promise<ApiResponse<PlanGroupDetail>>;
 }
 
 interface PortalAccess {
@@ -1045,6 +1046,57 @@ declare class PromoCodesResource {
     update(params: UpdatePromoCodeParams, options?: RequestOptions): Promise<ApiResponse<PromoCodeDetail>>;
 }
 
+interface QuotaEvent {
+    id: string;
+    customerId: CustomerID;
+    featureCode: string;
+    previousBalance: number;
+    newBalance: number;
+    ts: string;
+    createdAt: string;
+}
+interface QuotaAllowance {
+    featureCode: string;
+    current: number;
+    included: number;
+    remaining: number | null;
+    billedQuantity?: number;
+    unlimited: boolean;
+    overageEnabled: boolean;
+    asOf: string | null;
+}
+interface AddQuotaParams {
+    customerId: CustomerID;
+    featureCode: string;
+    count?: number;
+}
+interface SetQuotaParams {
+    customerId: CustomerID;
+    featureCode: string;
+    count: number;
+}
+interface RemoveQuotaParams {
+    customerId: CustomerID;
+    featureCode: string;
+    count?: number;
+}
+interface GetQuotaParams {
+    customerId: CustomerID;
+    featureCode: string;
+}
+interface GetAllQuotaParams {
+    customerId: CustomerID;
+}
+declare class QuotaResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    add(params: AddQuotaParams, options?: RequestOptions): Promise<ApiResponse<QuotaEvent>>;
+    set(params: SetQuotaParams, options?: RequestOptions): Promise<ApiResponse<QuotaEvent>>;
+    remove(params: RemoveQuotaParams, options?: RequestOptions): Promise<ApiResponse<QuotaEvent>>;
+    get(params: GetQuotaParams): Promise<ApiResponse<QuotaAllowance>>;
+    getAll(params: GetAllQuotaParams): Promise<ApiResponse<QuotaAllowance[]>>;
+}
+
 interface SeatEvent {
     id: string;
     object: "seat";
@@ -1106,7 +1158,7 @@ type SubscriptionStatus = "draft" | "pending_payment" | "trialing" | "active" |
 interface FeatureSummary {
     code: string;
     name: string;
-    type: "boolean" | "usage" | "seats";
+    type: FeatureType;
     enabled?: boolean;
     usage?: {
         current: number;
@@ -1247,6 +1299,8 @@ interface ChangePlanParams {
     id: string;
     newPlanId?: string;
     newBillingInterval?: BillingInterval;
+    /** Where to redirect after checkout when a free→paid change requires payment. */
+    successUrl?: string;
 }
 interface ChangePlanResult {
     id: string;
@@ -1635,6 +1689,7 @@ declare class Commet<_TConfig = unknown> {
     readonly plans: PlansResource;
     readonly portal: PortalResource;
     readonly promoCodes: PromoCodesResource;
+    readonly quota: QuotaResource;
     readonly seats: SeatsResource;
     readonly subscriptions: SubscriptionsResource;
     readonly transactions: TransactionsResource;
@@ -1649,4 +1704,4 @@ declare function registerIntegration(name: string, version: string): void;
 declare const API_VERSION = "2026-05-25";
 declare const SDK_VERSION: string;
 
-export { API_VERSION, type ActivateAddonParams, type ActivateAddonResult, type ActiveAddon, type ActiveSubscription, type AddAiModelPricingFeatureParams, type AddFixedPricingFeatureParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddSeatsParams, type Addon, type AdjustBalanceParams, type AdjustBalanceResult, type AiModelPricingFeatureManage, type ApiErrorDetail, type ApiKey, type ApiKeyCreated, type ApiResponse, type BalanceAddon, type BillingConfig, type BillingInterval, type BooleanAddon, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type ChangePlanParams, type ChangePlanResult, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CreateAddonParams, type CreateAdjustmentParams, type CreateAdjustmentResult, type CreateApiKeyParams, type CreateBalanceAddonParams, type CreateBooleanAddonParams, type CreateCreditPackParams, type CreateCreditsAddonParams, type CreateParams as CreateCustomerParams, type CreateFeatureParams, type CreateMeteredAddonParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedSubscription, type CreditPack, type CreditPackDetail, type CreditsAddon, type Currency, type Customer, type CustomerAddress, type CustomerID, type BatchResult as CustomersBatchResult, type DeactivateAddonParams, type DeactivateAddonResult, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteResult, type DeleteWebhookParams, type DiscountSummary, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureSummary, type FeatureType, type FixedPricingFeatureManage, type GetActiveParams, type GetAddonParams, type GetAllBalancesParams, type GetBalanceParams, type GetCustomerParams, type GetDownloadUrlParams, type GetFeatureParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPromoCodeParams, type GetTransactionParams, type GetUrlParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type InvoiceDetail, type InvoiceDownloadResult, type InvoiceLineItem, type InvoiceListItem, type InvoiceSendResult, type InvoiceStatusResult, 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 MeteredAddon, type PaginatedList, type PaginatedResponse, type Plan, type PlanDef, type PlanDetail, type PlanFeature, type PlanFeatureManage, type PlanFeatureValue, type PlanGroup, type PlanGroupDetail, type PlanID, type PlanManage, type PlanPrice, type PlanPriceManage, type PortalAccess, type PreviewChangeParams, type PreviewChangeResult, type PriceDef, type PromoCode, type PromoCodeDetail, type PurchaseCreditsParams, type PurchaseCreditsResult, type RefundTransactionParams, type RegionalPriceResult, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveResult, type RemoveSeatsParams, type ReorderPlansParams, type RequestOptions, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatEvent, type SendInvoiceParams, type SetAllSeatsParams, type SetDefaultPriceParams, type SetRegionalPricesParams, type SetSeatsParams, type SetVisibilityParams, type Subscription, type SubscriptionListItem, type SubscriptionStatus, type TestWebhookParams, type TopupBalanceParams, type TopupBalanceResult, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type TransactionDetail, type TransactionListItem, type TransactionRefundResult, type TransactionRetryResult, type UncancelParams, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateParams as UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UsageCheckResult, type UsageEvent, type UsageEventProperty, 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 ActivateAddonResult, type ActiveAddon, type ActiveSubscription, type AddAiModelPricingFeatureParams, type AddFixedPricingFeatureParams, type AddPlanFeatureParams, type AddPlanPriceParams, type AddPlanToGroupParams, type AddQuotaParams, type AddSeatsParams, type Addon, type AdjustBalanceParams, type AdjustBalanceResult, type AiModelPricingFeatureManage, type ApiErrorDetail, type ApiKey, type ApiKeyCreated, type ApiResponse, type BalanceAddon, type BillingConfig, type BillingInterval, type BooleanAddon, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type ChangePlanParams, type ChangePlanResult, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type CreateAddonParams, type CreateAdjustmentParams, type CreateAdjustmentResult, type CreateApiKeyParams, type CreateBalanceAddonParams, type CreateBooleanAddonParams, type CreateCreditPackParams, type CreateCreditsAddonParams, type CreateParams as CreateCustomerParams, type CreateFeatureParams, type CreateMeteredAddonParams, type CreatePlanGroupParams, type CreatePlanParams, type CreatePromoCodeParams, type CreateSubscriptionParams, type CreateWebhookParams, type CreatedSubscription, type CreditPack, type CreditPackDetail, type CreditsAddon, type Currency, type Customer, type CustomerAddress, type CustomerID, type BatchResult as CustomersBatchResult, type DeactivateAddonParams, type DeactivateAddonResult, type DeleteAddonParams, type DeleteApiKeyParams, type DeleteCreditPackParams, type DeleteFeatureParams, type DeletePlanGroupParams, type DeletePlanParams, type DeletePlanPriceParams, type DeleteRegionalPricesParams, type DeleteResult, type DeleteWebhookParams, type DiscountSummary, type EventID, type Feature, type FeatureAccess, type FeatureDef, type FeatureSummary, type FeatureType, type FixedPricingFeatureManage, type GetActiveParams, type GetAddonParams, type GetAllBalancesParams, type GetAllQuotaParams, type GetBalanceParams, type GetCustomerParams, type GetDownloadUrlParams, type GetFeatureParams, type GetInvoiceParams, type GetPlanGroupParams, type GetPromoCodeParams, type GetQuotaParams, type GetTransactionParams, type GetUrlParams, type GetWebhookParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type InvoiceDetail, type InvoiceDownloadResult, type InvoiceLineItem, type InvoiceListItem, type InvoiceSendResult, type InvoiceStatusResult, 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 MeteredAddon, type PaginatedList, type PaginatedResponse, type Plan, type PlanDef, type PlanDetail, type PlanFeature, type PlanFeatureManage, type PlanFeatureValue, type PlanGroup, type PlanGroupDetail, type PlanID, type PlanManage, type PlanPrice, type PlanPriceManage, type PortalAccess, type PreviewChangeParams, type PreviewChangeResult, type PriceDef, type PromoCode, type PromoCodeDetail, type PurchaseCreditsParams, type PurchaseCreditsResult, type QuotaAllowance, type QuotaEvent, type RefundTransactionParams, type RegionalPriceResult, type RemovePlanFeatureParams, type RemovePlanFromGroupParams, type RemoveQuotaParams, type RemoveResult, type RemoveSeatsParams, type ReorderPlansParams, type RequestOptions, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, type RetryTransactionParams, SDK_VERSION, type SeatBalance, type SeatEvent, type SendInvoiceParams, type SetAllSeatsParams, type SetDefaultPriceParams, type SetQuotaParams, type SetRegionalPricesParams, type SetSeatsParams, type SetVisibilityParams, type Subscription, type SubscriptionListItem, type SubscriptionStatus, type TestWebhookParams, type TopupBalanceParams, type TopupBalanceResult, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type TransactionDetail, type TransactionListItem, type TransactionRefundResult, type TransactionRetryResult, type UncancelParams, type UpdateAddonParams, type UpdateCreditPackParams, type UpdateParams as UpdateCustomerParams, type UpdateFeatureParams, type UpdateInvoiceStatusParams, type UpdatePlanFeatureParams, type UpdatePlanGroupParams, type UpdatePlanParams, type UpdatePlanPriceParams, type UpdatePromoCodeParams, type UpdateWebhookParams, type UsageCheckResult, type UsageEvent, type UsageEventProperty, type WebhookData, type WebhookEndpoint, type WebhookEndpointCreated, type WebhookEvent, type WebhookPayload, type WebhookTestResult, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };