@commet/node 5.3.0 → 5.5.0

package/dist/index.d.ts

@@ -171,6 +171,285 @@ declare class CommetHTTPClient {
     private sleep;
 }
 
+type PlanID = `plan_${string}`;
+type BillingInterval = "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
+type FeatureType = "boolean" | "usage" | "seats" | "quota";
+type ConsumptionModel = "metered" | "credits" | "balance";
+type DiscountType = "percentage" | "amount";
+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: DiscountType | 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: ConsumptionModel | 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: DiscountType | 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?: ConsumptionModel;
+    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>>;
+}
+
+type AddonConsumptionModel = "boolean" | "metered" | "credits" | "balance";
 interface ActiveAddon {
     object: "addon";
     livemode: boolean;
@@ -179,8 +458,8 @@ interface ActiveAddon {
     basePrice: number;
     featureCode: string;
     featureName: string;
-    featureType: string;
-    consumptionModel: string | null;
+    featureType: FeatureType;
+    consumptionModel: AddonConsumptionModel | null;
     activatedAt: string;
 }
 interface ListActiveAddonsParams {
@@ -310,411 +589,135 @@ declare class ApiKeysResource {
     list(params?: ListApiKeysParams): Promise<ApiResponse<ApiKey[]>>;
     /** Response includes full `apiKey` which is only returned once. */
     create(params: CreateApiKeyParams, options?: RequestOptions): Promise<ApiResponse<ApiKeyCreated>>;
-    delete(params: DeleteApiKeyParams, options?: RequestOptions): Promise<ApiResponse<void>>;
-}
-
-interface CreditPack {
-    id: string;
-    object: "credit_pack";
-    livemode: boolean;
-    name: string;
-    description: string | null;
-    credits: number;
-    price: number;
-    currency: string;
-}
-interface CreditPackDetail {
-    id: string;
-    object: "credit_pack";
-    livemode: boolean;
-    name: string;
-    description: string | null;
-    credits: number;
-    price: number;
-    isActive: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateCreditPackParams {
-    name: string;
-    description?: string;
-    credits: number;
-    price: number;
-    isActive?: boolean;
-}
-interface UpdateCreditPackParams {
-    id: string;
-    name?: string;
-    description?: string;
-    credits?: number;
-    price?: number;
-    isActive?: boolean;
-}
-interface DeleteCreditPackParams {
-    id: string;
-}
-declare class CreditPacksResource {
-    private httpClient;
-    constructor(httpClient: CommetHTTPClient);
-    list(): Promise<ApiResponse<CreditPack[]>>;
-    create(params: CreateCreditPackParams, options?: RequestOptions): Promise<ApiResponse<CreditPackDetail>>;
-    update(params: UpdateCreditPackParams, options?: RequestOptions): Promise<ApiResponse<CreditPackDetail>>;
-    delete(params: DeleteCreditPackParams, options?: RequestOptions): Promise<ApiResponse<{
-        id: string;
-        deleted: true;
-    }>>;
-}
-
-interface Customer {
-    id: CustomerID;
-    object: "customer";
-    livemode: boolean;
-    organizationId: string;
-    fullName?: string;
-    domain?: string;
-    website?: string;
-    billingEmail: string;
-    timezone?: string;
-    language?: string;
-    industry?: string;
-    employeeCount?: string;
-    metadata?: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CustomerAddress {
-    line1: string;
-    line2?: string;
-    city: string;
-    state?: string;
-    postalCode: string;
-    country: string;
-}
-interface CreateParams {
-    email: string;
-    id?: string;
-    fullName?: string;
-    domain?: string;
-    website?: string;
-    timezone?: string;
-    language?: string;
-    industry?: string;
-    metadata?: Record<string, unknown>;
-    address?: CustomerAddress;
-}
-interface GetCustomerParams {
-    id: CustomerID;
-}
-interface UpdateParams {
-    id: CustomerID;
-    email?: string;
-    fullName?: string;
-    domain?: string;
-    website?: string;
-    timezone?: string;
-    language?: string;
-    industry?: string;
-    metadata?: Record<string, unknown>;
-    address?: CustomerAddress;
-}
-interface ListCustomersParams extends ListParams {
-    search?: string;
-}
-interface BatchResult {
-    successful: Customer[];
-    failed: Array<{
-        index: number;
-        error: string;
-        data: CreateParams;
-    }>;
-}
-declare class CustomersResource {
-    private httpClient;
-    constructor(httpClient: CommetHTTPClient);
-    /** Idempotent when `id` is provided — returns existing customer instead of duplicating. */
-    create(params: CreateParams, options?: RequestOptions): Promise<ApiResponse<Customer>>;
-    createBatch(params: {
-        customers: CreateParams[];
-    }, options?: RequestOptions): Promise<ApiResponse<BatchResult>>;
-    get(params: GetCustomerParams): Promise<ApiResponse<Customer>>;
-    update(params: UpdateParams, options?: RequestOptions): Promise<ApiResponse<Customer>>;
-    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;
+    delete(params: DeleteApiKeyParams, options?: RequestOptions): Promise<ApiResponse<void>>;
 }
-interface AiModelPricingFeatureManage extends PlanFeatureManageBase {
-    pricingMode: "ai_model";
-    margin: number;
-    overageUnitPrice: null;
+
+interface CreditPack {
+    id: string;
+    object: "credit_pack";
+    livemode: boolean;
+    name: string;
+    description: string | null;
+    credits: number;
+    price: number;
+    currency: string;
 }
-type PlanFeatureManage = FixedPricingFeatureManage | AiModelPricingFeatureManage;
-interface PlanPriceManage {
+interface CreditPackDetail {
     id: string;
-    object: "plan_price";
+    object: "credit_pack";
     livemode: boolean;
-    planId: string;
-    billingInterval: BillingInterval;
+    name: string;
+    description: string | null;
+    credits: number;
     price: number;
-    isDefault: boolean;
-    trialDays: number;
-    includedBalance: number | null;
-    includedCredits: number | null;
-    introOfferEnabled: boolean;
-    introOfferDiscountType: "percentage" | "amount" | null;
-    introOfferDiscountValue: number | null;
-    introOfferDurationCycles: number | null;
+    isActive: boolean;
     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 {
+interface CreateCreditPackParams {
     name: string;
-    code: string;
     description?: string;
-    consumptionModel?: "metered" | "credits" | "balance";
-    isPublic?: boolean;
-    isFree?: boolean;
-    blockOnExhaustion?: boolean;
-    planGroupId?: string;
-    metadata?: Record<string, unknown>;
+    credits: number;
+    price: number;
+    isActive?: boolean;
 }
-interface UpdatePlanParams {
+interface UpdateCreditPackParams {
     id: string;
     name?: string;
     description?: string;
-    metadata?: Record<string, unknown>;
-    isPublic?: boolean;
-}
-interface DeletePlanParams {
-    id: string;
+    credits?: number;
+    price?: number;
+    isActive?: boolean;
 }
-interface SetVisibilityParams {
+interface DeleteCreditPackParams {
     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;
+declare class CreditPacksResource {
+    private httpClient;
+    constructor(httpClient: CommetHTTPClient);
+    list(): Promise<ApiResponse<CreditPack[]>>;
+    create(params: CreateCreditPackParams, options?: RequestOptions): Promise<ApiResponse<CreditPackDetail>>;
+    update(params: UpdateCreditPackParams, options?: RequestOptions): Promise<ApiResponse<CreditPackDetail>>;
+    delete(params: DeleteCreditPackParams, options?: RequestOptions): Promise<ApiResponse<{
+        id: string;
+        deleted: true;
+    }>>;
 }
-interface UpdateAiModelPricingFeatureParams extends UpdatePlanFeatureBase {
-    pricingMode: "ai_model";
-    margin?: number;
+
+interface Customer {
+    id: CustomerID;
+    object: "customer";
+    livemode: boolean;
+    organizationId: string;
+    fullName?: string;
+    domain?: string;
+    website?: string;
+    billingEmail: string;
+    timezone?: string;
+    language?: string;
+    industry?: string;
+    employeeCount?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
 }
-type UpdatePlanFeatureParams = UpdateFixedPricingFeatureParams | UpdateAiModelPricingFeatureParams;
-interface RemovePlanFeatureParams {
-    planId: string;
-    featureId: string;
+interface CustomerAddress {
+    line1: string;
+    line2?: string;
+    city: string;
+    state?: string;
+    postalCode: string;
+    country: 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 CreateParams {
+    email: string;
+    id?: string;
+    fullName?: string;
+    domain?: string;
+    website?: string;
+    timezone?: string;
+    language?: string;
+    industry?: string;
+    metadata?: Record<string, unknown>;
+    address?: CustomerAddress;
 }
-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 GetCustomerParams {
+    id: CustomerID;
 }
-interface DeletePlanPriceParams {
-    planId: string;
-    priceId: string;
+interface UpdateParams {
+    id: CustomerID;
+    email?: string;
+    fullName?: string;
+    domain?: string;
+    website?: string;
+    timezone?: string;
+    language?: string;
+    industry?: string;
+    metadata?: Record<string, unknown>;
+    address?: CustomerAddress;
 }
-interface SetDefaultPriceParams {
-    planId: string;
-    priceId: string;
+interface ListCustomersParams extends ListParams {
+    search?: string;
 }
-interface SetRegionalPricesParams {
-    planId: string;
-    priceId: string;
-    overrides: Array<{
-        currency: string;
-        price: number;
+interface BatchResult {
+    successful: Customer[];
+    failed: Array<{
+        index: number;
+        error: string;
+        data: CreateParams;
     }>;
 }
-interface DeleteRegionalPricesParams {
-    planId: string;
-    priceId: string;
-}
-declare class PlansResource {
+declare class CustomersResource {
     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>>;
+    /** Idempotent when `id` is provided — returns existing customer instead of duplicating. */
+    create(params: CreateParams, options?: RequestOptions): Promise<ApiResponse<Customer>>;
+    createBatch(params: {
+        customers: CreateParams[];
+    }, options?: RequestOptions): Promise<ApiResponse<BatchResult>>;
+    get(params: GetCustomerParams): Promise<ApiResponse<Customer>>;
+    update(params: UpdateParams, options?: RequestOptions): Promise<ApiResponse<Customer>>;
+    list(params?: ListCustomersParams): Promise<ApiResponse<Customer[]>>;
 }
 
 interface GetFeatureParams {
@@ -794,8 +797,12 @@ declare class FeaturesResource {
     }>>;
 }
 
+type InvoiceStatus = "draft" | "upcoming" | "outstanding" | "paid" | "void" | "uncollectible";
+type InvoiceType = "recurring" | "overage" | "plan_change" | "adjustment" | "credit_purchase" | "balance_topup" | "addon_activation";
+type InvoiceLineType = "plan_base" | "feature_overage" | "feature_seats" | "feature_quota" | "discount" | "credit" | "addon_base";
+type ChargeType = "standard" | "advance" | "true_up";
 interface InvoiceLineItem {
-    lineType: string;
+    lineType: InvoiceLineType;
     featureName: string | null;
     description: string | null;
     quantity: number;
@@ -804,10 +811,10 @@ interface InvoiceLineItem {
     includedAmount: number | null;
     usedAmount: number | null;
     overageAmount: number | null;
-    discountType: string | null;
+    discountType: DiscountType | null;
     discountValue: number | null;
     discountName: string | null;
-    chargeType: string | null;
+    chargeType: ChargeType | null;
 }
 interface InvoiceListItem {
     id: string;
@@ -816,8 +823,8 @@ interface InvoiceListItem {
     customerId: string;
     subscriptionId: string | null;
     invoiceNumber: string;
-    status: string;
-    invoiceType: string;
+    status: InvoiceStatus;
+    invoiceType: InvoiceType;
     currency: string;
     subtotal: number;
     discountAmount: number;
@@ -849,7 +856,7 @@ interface InvoiceSendResult {
 }
 interface InvoiceStatusResult {
     id: string;
-    status: string;
+    status: "paid" | "void";
     updatedAt: string;
 }
 interface CreateAdjustmentResult {
@@ -858,8 +865,8 @@ interface CreateAdjustmentResult {
     livemode: boolean;
     customerId: string;
     invoiceNumber: string;
-    status: string;
-    invoiceType: string;
+    status: "outstanding" | "paid";
+    invoiceType: InvoiceType;
     currency: string;
     subtotal: number;
     taxAmount: number;
@@ -873,7 +880,7 @@ interface CreateAdjustmentResult {
 }
 interface ListInvoicesParams {
     customerId?: string;
-    status?: string;
+    status?: InvoiceStatus;
     subscriptionId?: string;
     limit?: number;
     cursor?: string;
@@ -895,7 +902,7 @@ interface SendInvoiceParams {
 }
 interface UpdateInvoiceStatusParams {
     id: string;
-    status: string;
+    status: "paid" | "void";
 }
 declare class InvoicesResource {
     private httpClient;
@@ -1188,7 +1195,6 @@ interface DiscountSummary {
     name: string | null;
     endsAt: string | null;
 }
-type ConsumptionModel = "metered" | "credits" | "balance";
 interface ActiveSubscription {
     id: string;
     object: "subscription";
@@ -1274,6 +1280,11 @@ type PlanIdentifier = {
     planCode?: never;
     planId: string;
 };
+interface CustomIntroOffer {
+    discountType: "percentage" | "amount";
+    discountValue: number;
+    durationCycles: number;
+}
 type CreateSubscriptionParams = PlanIdentifier & {
     customerId: string;
 } & {
@@ -1283,6 +1294,7 @@ type CreateSubscriptionParams = PlanIdentifier & {
     name?: string;
     startDate?: string;
     successUrl?: string;
+    customIntroOffer?: CustomIntroOffer;
 };
 interface GetActiveParams {
     customerId: string;
@@ -1435,6 +1447,7 @@ declare class SubscriptionsResource {
     purchaseCredits(params: PurchaseCreditsParams, options?: RequestOptions): Promise<ApiResponse<PurchaseCreditsResult>>;
 }
 
+type TransactionStatus = "pending" | "succeeded" | "failed" | "refunded" | "disputed";
 interface TransactionListItem {
     id: string;
     object: "transaction";
@@ -1444,7 +1457,7 @@ interface TransactionListItem {
     subtotal: number;
     taxAmount: number;
     currency: string;
-    status: string;
+    status: TransactionStatus;
     customerEmail: string;
     customerName: string | null;
     paidAt: string | null;
@@ -1456,15 +1469,15 @@ interface TransactionDetail extends TransactionListItem {
 }
 interface TransactionRefundResult {
     id: string;
-    status: string;
+    status: "refunded";
 }
 interface TransactionRetryResult {
     id: string;
-    status: string;
+    status: "processing";
     retryInvoiceNumber: string;
 }
 interface ListTransactionsParams {
-    status?: string;
+    status?: TransactionStatus;
     customerEmail?: string;
     limit?: number;
     cursor?: string;
@@ -1489,6 +1502,7 @@ declare class TransactionsResource {
     retry(params: RetryTransactionParams, options?: RequestOptions): Promise<ApiResponse<TransactionRetryResult>>;
 }
 
+type UsageCheckDenialReason = "included_limit_reached" | "insufficient_credits" | "insufficient_balance";
 interface UsageEvent {
     id: EventID;
     object: "usage_event";
@@ -1535,7 +1549,7 @@ interface CheckUsageParams {
 }
 interface UsageCheckResult {
     allowed: boolean;
-    consumptionModel: string;
+    consumptionModel: ConsumptionModel;
     feature: string;
     quantity: number;
     current?: number;
@@ -1554,7 +1568,7 @@ interface UsageCheckResult {
     currentBalance?: number;
     blockOnExhaustion?: boolean;
     currency?: string;
-    reason?: string;
+    reason?: UsageCheckDenialReason;
     message?: string;
 }
 declare class UsageResource {
@@ -1704,4 +1718,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 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 };
+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 AddonConsumptionModel, 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 ChargeType, type CheckUsageParams, Commet, CommetAPIError, type CommetClientOptions, CommetError, CommetValidationError, type ConsumptionModel, 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 CustomIntroOffer, 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 DiscountType, 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 InvoiceLineType, type InvoiceListItem, type InvoiceSendResult, type InvoiceStatus, type InvoiceStatusResult, 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 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 TransactionStatus, 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 UsageCheckDenialReason, 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 };