@commet/node 4.3.0 → 4.4.0

package/dist/index.d.mts

@@ -1,4 +1,69 @@
-type CommetConfig = {
+type FeatureDef = {
+    name: string;
+    type: "boolean";
+    description?: string;
+} | {
+    name: string;
+    type: "usage";
+    unitName?: string;
+    description?: string;
+} | {
+    name: string;
+    type: "seats";
+    unitName?: string;
+    description?: string;
+};
+interface PriceDef {
+    interval: "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
+    /** Rate scale: 10000 = $1.00 */
+    amount: number;
+    trialDays?: number;
+}
+type PlanFeatureValue = boolean | {
+    included?: number;
+    unlimited?: boolean;
+    overage?: {
+        unitPrice: number;
+    };
+};
+interface PlanDef {
+    name: string;
+    description?: string;
+    consumptionModel?: "metered" | "credits" | "balance";
+    defaultInterval?: PriceDef["interval"];
+    isFree?: boolean;
+    isPublic?: boolean;
+    sortOrder?: number;
+    prices: PriceDef[];
+    features?: Record<string, PlanFeatureValue>;
+}
+interface BillingConfig {
+    features: Record<string, FeatureDef>;
+    plans: Record<string, PlanDef>;
+}
+declare function defineConfig<const T extends BillingConfig>(config: T): T;
+type InferFeatureCodes<T> = T extends {
+    features: infer F;
+} ? keyof F & string : never;
+type InferPlanCodes<T> = T extends {
+    plans: infer P;
+} ? keyof P & string : never;
+type InferSeatCodes<T> = T extends {
+    features: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        type: "seats";
+    } ? K & string : never;
+}[keyof F] : never;
+type InferUsageCodes<T> = T extends {
+    features: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        type: "usage";
+    } ? K & string : never;
+}[keyof F] : never;
+
+type CommetClientOptions = {
     apiKey: string;
     apiVersion?: string;
     debug?: boolean;
@@ -6,6 +71,8 @@ type CommetConfig = {
     retries?: number;
     telemetry?: boolean;
 };
+/** @deprecated Use CommetClientOptions */
+type CommetConfig = CommetClientOptions;
 interface ApiResponse<T = unknown> {
     success: boolean;
     data?: T;
@@ -55,38 +122,26 @@ interface RequestOptions {
     idempotencyKey?: string;
     timeout?: number;
 }
-/**
- * Generated types interface - augmented by CLI after 'commet pull'
- *
- * This interface gets filled by module augmentation when you run `commet pull`.
- * The CLI generates a .commet/types.d.ts file that augments this interface with your
- * organization's specific feature codes, seat types, and plan codes.
- *
- * @example
- * // After running `commet pull`, TypeScript will automatically know your types:
- * await commet.usage.track({
- *   feature: 'api_calls', // Autocomplete works!
- *   externalId: 'user_123'
- * });
- */
-interface CommetGeneratedTypes {
-}
-type GeneratedSeatType = CommetGeneratedTypes extends {
-    seatType: infer T;
-} ? T : string;
-type GeneratedPlanCode = CommetGeneratedTypes extends {
-    planCode: infer T;
-} ? T : string;
-type GeneratedFeatureCode = CommetGeneratedTypes extends {
-    featureCode: infer T;
-} ? T : string;
+
+type ResolvedFeatureCode<TConfig> = [
+    InferFeatureCodes<TConfig>
+] extends [never] ? string : InferFeatureCodes<TConfig>;
+type ResolvedSeatCode<TConfig> = [InferSeatCodes<TConfig>] extends [
+    never
+] ? string : InferSeatCodes<TConfig>;
+type ResolvedUsageCode<TConfig> = [InferUsageCodes<TConfig>] extends [
+    never
+] ? string : InferUsageCodes<TConfig>;
+type ResolvedPlanCode<TConfig> = [InferPlanCodes<TConfig>] extends [
+    never
+] ? string : InferPlanCodes<TConfig>;
 
 declare class CommetHTTPClient {
     private config;
     private retryConfig;
     private telemetryEnabled;
     private lastRequestMetrics;
-    constructor(config: CommetConfig);
+    constructor(config: CommetClientOptions);
     get<T = unknown>(endpoint: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<ApiResponse<T>>;
     post<T = unknown>(endpoint: string, data?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
     put<T = unknown>(endpoint: string, data?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
@@ -113,7 +168,7 @@ declare class CommetHTTPClient {
 
 interface FeatureParams {
     customerId: CustomerID;
-    code: GeneratedFeatureCode;
+    code: string;
 }
 type GetFeatureParams = FeatureParams;
 type CheckFeatureParams = FeatureParams;
@@ -189,23 +244,23 @@ interface SeatBalance {
 }
 interface AddParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface RemoveParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface SetParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface SetAllParams {
@@ -214,9 +269,9 @@ interface SetAllParams {
 }
 interface GetBalanceParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
 }
 interface GetAllBalancesParams {
     customerId: CustomerID;
@@ -329,7 +384,7 @@ declare class PlansResource {
      * console.log(plan.data.prices); // [{ billingInterval: 'monthly', price: 9900 }]
      * ```
      */
-    get(planCode: GeneratedPlanCode): Promise<ApiResponse<PlanDetail>>;
+    get(planCode: string): Promise<ApiResponse<PlanDetail>>;
 }
 
 type SubscriptionStatus = "draft" | "pending_payment" | "trialing" | "active" | "paused" | "past_due" | "canceled" | "expired";
@@ -440,7 +495,7 @@ interface Subscription {
     updatedAt: string;
 }
 type PlanIdentifier = {
-    planCode: GeneratedPlanCode;
+    planCode: string;
     planId?: never;
 } | {
     planCode?: never;
@@ -524,7 +579,7 @@ interface UsageEventProperty {
     createdAt: string;
 }
 interface TrackBaseParams {
-    feature: GeneratedFeatureCode;
+    feature: string;
     customerId: CustomerID;
     idempotencyKey?: string;
     timestamp?: string;
@@ -549,23 +604,7 @@ declare class UsageResource {
     track(params: TrackParams, options?: RequestOptions): Promise<ApiResponse<UsageEvent>>;
 }
 
-/**
- * Customer-scoped API context
- *
- * Provides a cleaner API where you don't have to pass customerId
- * on every call. All operations are scoped to a specific customer.
- *
- * @example
- * ```typescript
- * const customer = commet.customer("user_123");
- *
- * // All operations are now scoped to this customer
- * const seats = await customer.features.get("team_members");
- * await customer.seats.add("editor_seats");
- * await customer.usage.track("api_call");
- * ```
- */
-declare class CustomerContext {
+declare class CustomerContext<TConfig = unknown> {
     private readonly customerId;
     private readonly featuresResource;
     private readonly seatsResource;
@@ -580,19 +619,19 @@ declare class CustomerContext {
         portal: PortalResource;
     });
     features: {
-        get: (code: string, options?: RequestOptions) => Promise<ApiResponse<FeatureAccess>>;
-        check: (code: string, options?: RequestOptions) => Promise<ApiResponse<CheckResult>>;
-        canUse: (code: string, options?: RequestOptions) => Promise<ApiResponse<CanUseResult>>;
+        get: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<FeatureAccess>>;
+        check: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<CheckResult>>;
+        canUse: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<CanUseResult>>;
         list: (options?: RequestOptions) => Promise<ApiResponse<FeatureAccess[]>>;
     };
     seats: {
-        add: (featureCode: string, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        remove: (featureCode: string, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        set: (featureCode: string, count: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        getBalance: (featureCode: string) => Promise<ApiResponse<SeatBalance>>;
+        add: (featureCode: ResolvedSeatCode<TConfig>, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        remove: (featureCode: ResolvedSeatCode<TConfig>, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        set: (featureCode: ResolvedSeatCode<TConfig>, count: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        getBalance: (featureCode: ResolvedSeatCode<TConfig>) => Promise<ApiResponse<SeatBalance>>;
     };
     usage: {
-        track: (feature: string, value?: number, properties?: Record<string, string>, options?: RequestOptions) => Promise<ApiResponse<UsageEvent>>;
+        track: (feature: ResolvedUsageCode<TConfig>, value?: number, properties?: Record<string, string>, options?: RequestOptions) => Promise<ApiResponse<UsageEvent>>;
     };
     subscription: {
         get: () => Promise<ApiResponse<ActiveSubscription | null>>;
@@ -833,7 +872,7 @@ declare class Webhooks {
 /**
  * Main Commet SDK client
  */
-declare class Commet {
+declare class Commet<TConfig = unknown> {
     private httpClient;
     readonly customers: CustomersResource;
     readonly creditPacks: CreditPacksResource;
@@ -844,7 +883,7 @@ declare class Commet {
     readonly portal: PortalResource;
     readonly features: FeaturesResource;
     readonly webhooks: Webhooks;
-    constructor(config: CommetConfig);
+    constructor(config: CommetClientOptions);
     /**
      * Create a customer-scoped context for cleaner API usage
      *
@@ -858,8 +897,9 @@ declare class Commet {
      * await customer.usage.track("api_call");
      * ```
      */
-    customer(customerId: string): CustomerContext;
+    customer(customerId: string): CustomerContext<TConfig>;
 }
+declare function createCommet<const TConfig extends BillingConfig>(_billingConfig: TConfig, options: CommetClientOptions): Commet<TConfig>;
 
 declare function registerIntegration(name: string, version: string): void;
 
@@ -870,4 +910,4 @@ declare const SDK_VERSION: string;
  * Commet SDK - Billing and usage tracking for SaaS
  */
 
-export { API_VERSION, type ActiveSubscription, type AddParams as AddSeatsParams, type ApiResponse, type BillingInterval, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type CheckFeatureParams, type CheckResult, Commet, CommetAPIError, type CommetConfig, CommetError, type CommetGeneratedTypes, CommetValidationError, type CreateParams as CreateCustomerParams, type CreateSubscriptionParams, type CreatedSubscription, type CreditPack, type Currency, type Customer, type CustomerAddress, CustomerContext, type CustomerID, type BatchResult as CustomersBatchResult, type DiscountSummary, type EventID, type FeatureAccess, type FeatureSummary, type FeatureType, type GeneratedFeatureCode, type GeneratedPlanCode, type GeneratedSeatType, type GetAllBalancesParams, type GetBalanceParams, type GetFeatureParams, type GetUrlParams, type ListCustomersParams, type ListPlansParams, type PaginatedList, type PaginatedResponse, type Plan, type PlanDetail, type PlanFeature, type PlanID, type PlanPrice, type PortalAccess, type RemoveParams as RemoveSeatsParams, type RequestOptions, SDK_VERSION, type SeatBalance, type SeatEvent, type SetAllParams as SetAllSeatsParams, type SetParams as SetSeatsParams, type Subscription, type SubscriptionStatus, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type UpdateParams as UpdateCustomerParams, type UsageEvent, type UsageEventProperty, type WebhookData, type WebhookEvent, type WebhookPayload, Webhooks, Commet as default, registerIntegration };
+export { API_VERSION, type ActiveSubscription, type AddParams as AddSeatsParams, type ApiResponse, type BillingConfig, type BillingInterval, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type CheckFeatureParams, type CheckResult, Commet, CommetAPIError, type CommetClientOptions, type CommetConfig, CommetError, CommetValidationError, type CreateParams as CreateCustomerParams, type CreateSubscriptionParams, type CreatedSubscription, type CreditPack, type Currency, type Customer, type CustomerAddress, CustomerContext, type CustomerID, type BatchResult as CustomersBatchResult, type DiscountSummary, type EventID, type FeatureAccess, type FeatureDef, type FeatureSummary, type FeatureType, type GetAllBalancesParams, type GetBalanceParams, type GetFeatureParams, type GetUrlParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type ListCustomersParams, type ListPlansParams, type PaginatedList, type PaginatedResponse, type Plan, type PlanDef, type PlanDetail, type PlanFeature, type PlanFeatureValue, type PlanID, type PlanPrice, type PortalAccess, type PriceDef, type RemoveParams as RemoveSeatsParams, type RequestOptions, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, SDK_VERSION, type SeatBalance, type SeatEvent, type SetAllParams as SetAllSeatsParams, type SetParams as SetSeatsParams, type Subscription, type SubscriptionStatus, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type UpdateParams as UpdateCustomerParams, type UsageEvent, type UsageEventProperty, type WebhookData, type WebhookEvent, type WebhookPayload, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };

package/dist/index.d.ts

@@ -1,4 +1,69 @@
-type CommetConfig = {
+type FeatureDef = {
+    name: string;
+    type: "boolean";
+    description?: string;
+} | {
+    name: string;
+    type: "usage";
+    unitName?: string;
+    description?: string;
+} | {
+    name: string;
+    type: "seats";
+    unitName?: string;
+    description?: string;
+};
+interface PriceDef {
+    interval: "weekly" | "monthly" | "quarterly" | "yearly" | "one_time";
+    /** Rate scale: 10000 = $1.00 */
+    amount: number;
+    trialDays?: number;
+}
+type PlanFeatureValue = boolean | {
+    included?: number;
+    unlimited?: boolean;
+    overage?: {
+        unitPrice: number;
+    };
+};
+interface PlanDef {
+    name: string;
+    description?: string;
+    consumptionModel?: "metered" | "credits" | "balance";
+    defaultInterval?: PriceDef["interval"];
+    isFree?: boolean;
+    isPublic?: boolean;
+    sortOrder?: number;
+    prices: PriceDef[];
+    features?: Record<string, PlanFeatureValue>;
+}
+interface BillingConfig {
+    features: Record<string, FeatureDef>;
+    plans: Record<string, PlanDef>;
+}
+declare function defineConfig<const T extends BillingConfig>(config: T): T;
+type InferFeatureCodes<T> = T extends {
+    features: infer F;
+} ? keyof F & string : never;
+type InferPlanCodes<T> = T extends {
+    plans: infer P;
+} ? keyof P & string : never;
+type InferSeatCodes<T> = T extends {
+    features: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        type: "seats";
+    } ? K & string : never;
+}[keyof F] : never;
+type InferUsageCodes<T> = T extends {
+    features: infer F;
+} ? {
+    [K in keyof F]: F[K] extends {
+        type: "usage";
+    } ? K & string : never;
+}[keyof F] : never;
+
+type CommetClientOptions = {
     apiKey: string;
     apiVersion?: string;
     debug?: boolean;
@@ -6,6 +71,8 @@ type CommetConfig = {
     retries?: number;
     telemetry?: boolean;
 };
+/** @deprecated Use CommetClientOptions */
+type CommetConfig = CommetClientOptions;
 interface ApiResponse<T = unknown> {
     success: boolean;
     data?: T;
@@ -55,38 +122,26 @@ interface RequestOptions {
     idempotencyKey?: string;
     timeout?: number;
 }
-/**
- * Generated types interface - augmented by CLI after 'commet pull'
- *
- * This interface gets filled by module augmentation when you run `commet pull`.
- * The CLI generates a .commet/types.d.ts file that augments this interface with your
- * organization's specific feature codes, seat types, and plan codes.
- *
- * @example
- * // After running `commet pull`, TypeScript will automatically know your types:
- * await commet.usage.track({
- *   feature: 'api_calls', // Autocomplete works!
- *   externalId: 'user_123'
- * });
- */
-interface CommetGeneratedTypes {
-}
-type GeneratedSeatType = CommetGeneratedTypes extends {
-    seatType: infer T;
-} ? T : string;
-type GeneratedPlanCode = CommetGeneratedTypes extends {
-    planCode: infer T;
-} ? T : string;
-type GeneratedFeatureCode = CommetGeneratedTypes extends {
-    featureCode: infer T;
-} ? T : string;
+
+type ResolvedFeatureCode<TConfig> = [
+    InferFeatureCodes<TConfig>
+] extends [never] ? string : InferFeatureCodes<TConfig>;
+type ResolvedSeatCode<TConfig> = [InferSeatCodes<TConfig>] extends [
+    never
+] ? string : InferSeatCodes<TConfig>;
+type ResolvedUsageCode<TConfig> = [InferUsageCodes<TConfig>] extends [
+    never
+] ? string : InferUsageCodes<TConfig>;
+type ResolvedPlanCode<TConfig> = [InferPlanCodes<TConfig>] extends [
+    never
+] ? string : InferPlanCodes<TConfig>;
 
 declare class CommetHTTPClient {
     private config;
     private retryConfig;
     private telemetryEnabled;
     private lastRequestMetrics;
-    constructor(config: CommetConfig);
+    constructor(config: CommetClientOptions);
     get<T = unknown>(endpoint: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<ApiResponse<T>>;
     post<T = unknown>(endpoint: string, data?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
     put<T = unknown>(endpoint: string, data?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
@@ -113,7 +168,7 @@ declare class CommetHTTPClient {
 
 interface FeatureParams {
     customerId: CustomerID;
-    code: GeneratedFeatureCode;
+    code: string;
 }
 type GetFeatureParams = FeatureParams;
 type CheckFeatureParams = FeatureParams;
@@ -189,23 +244,23 @@ interface SeatBalance {
 }
 interface AddParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface RemoveParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface SetParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
     count: number;
 }
 interface SetAllParams {
@@ -214,9 +269,9 @@ interface SetAllParams {
 }
 interface GetBalanceParams {
     customerId: CustomerID;
-    featureCode?: GeneratedFeatureCode;
+    featureCode?: string;
     /** @deprecated Use featureCode instead */
-    seatType?: GeneratedSeatType;
+    seatType?: string;
 }
 interface GetAllBalancesParams {
     customerId: CustomerID;
@@ -329,7 +384,7 @@ declare class PlansResource {
      * console.log(plan.data.prices); // [{ billingInterval: 'monthly', price: 9900 }]
      * ```
      */
-    get(planCode: GeneratedPlanCode): Promise<ApiResponse<PlanDetail>>;
+    get(planCode: string): Promise<ApiResponse<PlanDetail>>;
 }
 
 type SubscriptionStatus = "draft" | "pending_payment" | "trialing" | "active" | "paused" | "past_due" | "canceled" | "expired";
@@ -440,7 +495,7 @@ interface Subscription {
     updatedAt: string;
 }
 type PlanIdentifier = {
-    planCode: GeneratedPlanCode;
+    planCode: string;
     planId?: never;
 } | {
     planCode?: never;
@@ -524,7 +579,7 @@ interface UsageEventProperty {
     createdAt: string;
 }
 interface TrackBaseParams {
-    feature: GeneratedFeatureCode;
+    feature: string;
     customerId: CustomerID;
     idempotencyKey?: string;
     timestamp?: string;
@@ -549,23 +604,7 @@ declare class UsageResource {
     track(params: TrackParams, options?: RequestOptions): Promise<ApiResponse<UsageEvent>>;
 }
 
-/**
- * Customer-scoped API context
- *
- * Provides a cleaner API where you don't have to pass customerId
- * on every call. All operations are scoped to a specific customer.
- *
- * @example
- * ```typescript
- * const customer = commet.customer("user_123");
- *
- * // All operations are now scoped to this customer
- * const seats = await customer.features.get("team_members");
- * await customer.seats.add("editor_seats");
- * await customer.usage.track("api_call");
- * ```
- */
-declare class CustomerContext {
+declare class CustomerContext<TConfig = unknown> {
     private readonly customerId;
     private readonly featuresResource;
     private readonly seatsResource;
@@ -580,19 +619,19 @@ declare class CustomerContext {
         portal: PortalResource;
     });
     features: {
-        get: (code: string, options?: RequestOptions) => Promise<ApiResponse<FeatureAccess>>;
-        check: (code: string, options?: RequestOptions) => Promise<ApiResponse<CheckResult>>;
-        canUse: (code: string, options?: RequestOptions) => Promise<ApiResponse<CanUseResult>>;
+        get: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<FeatureAccess>>;
+        check: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<CheckResult>>;
+        canUse: (code: ResolvedFeatureCode<TConfig>, options?: RequestOptions) => Promise<ApiResponse<CanUseResult>>;
         list: (options?: RequestOptions) => Promise<ApiResponse<FeatureAccess[]>>;
     };
     seats: {
-        add: (featureCode: string, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        remove: (featureCode: string, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        set: (featureCode: string, count: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
-        getBalance: (featureCode: string) => Promise<ApiResponse<SeatBalance>>;
+        add: (featureCode: ResolvedSeatCode<TConfig>, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        remove: (featureCode: ResolvedSeatCode<TConfig>, count?: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        set: (featureCode: ResolvedSeatCode<TConfig>, count: number, options?: RequestOptions) => Promise<ApiResponse<SeatEvent>>;
+        getBalance: (featureCode: ResolvedSeatCode<TConfig>) => Promise<ApiResponse<SeatBalance>>;
     };
     usage: {
-        track: (feature: string, value?: number, properties?: Record<string, string>, options?: RequestOptions) => Promise<ApiResponse<UsageEvent>>;
+        track: (feature: ResolvedUsageCode<TConfig>, value?: number, properties?: Record<string, string>, options?: RequestOptions) => Promise<ApiResponse<UsageEvent>>;
     };
     subscription: {
         get: () => Promise<ApiResponse<ActiveSubscription | null>>;
@@ -833,7 +872,7 @@ declare class Webhooks {
 /**
  * Main Commet SDK client
  */
-declare class Commet {
+declare class Commet<TConfig = unknown> {
     private httpClient;
     readonly customers: CustomersResource;
     readonly creditPacks: CreditPacksResource;
@@ -844,7 +883,7 @@ declare class Commet {
     readonly portal: PortalResource;
     readonly features: FeaturesResource;
     readonly webhooks: Webhooks;
-    constructor(config: CommetConfig);
+    constructor(config: CommetClientOptions);
     /**
      * Create a customer-scoped context for cleaner API usage
      *
@@ -858,8 +897,9 @@ declare class Commet {
      * await customer.usage.track("api_call");
      * ```
      */
-    customer(customerId: string): CustomerContext;
+    customer(customerId: string): CustomerContext<TConfig>;
 }
+declare function createCommet<const TConfig extends BillingConfig>(_billingConfig: TConfig, options: CommetClientOptions): Commet<TConfig>;
 
 declare function registerIntegration(name: string, version: string): void;
 
@@ -870,4 +910,4 @@ declare const SDK_VERSION: string;
  * Commet SDK - Billing and usage tracking for SaaS
  */
 
-export { API_VERSION, type ActiveSubscription, type AddParams as AddSeatsParams, type ApiResponse, type BillingInterval, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type CheckFeatureParams, type CheckResult, Commet, CommetAPIError, type CommetConfig, CommetError, type CommetGeneratedTypes, CommetValidationError, type CreateParams as CreateCustomerParams, type CreateSubscriptionParams, type CreatedSubscription, type CreditPack, type Currency, type Customer, type CustomerAddress, CustomerContext, type CustomerID, type BatchResult as CustomersBatchResult, type DiscountSummary, type EventID, type FeatureAccess, type FeatureSummary, type FeatureType, type GeneratedFeatureCode, type GeneratedPlanCode, type GeneratedSeatType, type GetAllBalancesParams, type GetBalanceParams, type GetFeatureParams, type GetUrlParams, type ListCustomersParams, type ListPlansParams, type PaginatedList, type PaginatedResponse, type Plan, type PlanDetail, type PlanFeature, type PlanID, type PlanPrice, type PortalAccess, type RemoveParams as RemoveSeatsParams, type RequestOptions, SDK_VERSION, type SeatBalance, type SeatEvent, type SetAllParams as SetAllSeatsParams, type SetParams as SetSeatsParams, type Subscription, type SubscriptionStatus, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type UpdateParams as UpdateCustomerParams, type UsageEvent, type UsageEventProperty, type WebhookData, type WebhookEvent, type WebhookPayload, Webhooks, Commet as default, registerIntegration };
+export { API_VERSION, type ActiveSubscription, type AddParams as AddSeatsParams, type ApiResponse, type BillingConfig, type BillingInterval, type CanUseFeatureParams, type CanUseResult, type CancelParams, type CancellationSummary, type CheckFeatureParams, type CheckResult, Commet, CommetAPIError, type CommetClientOptions, type CommetConfig, CommetError, CommetValidationError, type CreateParams as CreateCustomerParams, type CreateSubscriptionParams, type CreatedSubscription, type CreditPack, type Currency, type Customer, type CustomerAddress, CustomerContext, type CustomerID, type BatchResult as CustomersBatchResult, type DiscountSummary, type EventID, type FeatureAccess, type FeatureDef, type FeatureSummary, type FeatureType, type GetAllBalancesParams, type GetBalanceParams, type GetFeatureParams, type GetUrlParams, type InferFeatureCodes, type InferPlanCodes, type InferSeatCodes, type InferUsageCodes, type ListCustomersParams, type ListPlansParams, type PaginatedList, type PaginatedResponse, type Plan, type PlanDef, type PlanDetail, type PlanFeature, type PlanFeatureValue, type PlanID, type PlanPrice, type PortalAccess, type PriceDef, type RemoveParams as RemoveSeatsParams, type RequestOptions, type ResolvedFeatureCode, type ResolvedPlanCode, type ResolvedSeatCode, type ResolvedUsageCode, SDK_VERSION, type SeatBalance, type SeatEvent, type SetAllParams as SetAllSeatsParams, type SetParams as SetSeatsParams, type Subscription, type SubscriptionStatus, type TrackModelTokensParams, type TrackParams, type TrackUsageParams, type UpdateParams as UpdateCustomerParams, type UsageEvent, type UsageEventProperty, type WebhookData, type WebhookEvent, type WebhookPayload, Webhooks, createCommet, Commet as default, defineConfig, registerIntegration };

package/dist/index.js

@@ -38,7 +38,9 @@ __export(index_exports, {
   CustomerContext: () => CustomerContext,
   SDK_VERSION: () => SDK_VERSION,
   Webhooks: () => Webhooks,
+  createCommet: () => createCommet,
   default: () => index_default,
+  defineConfig: () => defineConfig,
   registerIntegration: () => registerIntegration
 });
 module.exports = __toCommonJS(index_exports);
@@ -542,7 +544,7 @@ var CommetValidationError = class extends CommetError {
 
 // src/version.ts
 var API_VERSION = "2026-05-18";
-var SDK_VERSION = "4.3.0";
+var SDK_VERSION = "4.4.0";
 
 // src/utils/telemetry.ts
 var registeredIntegrations = /* @__PURE__ */ new Set();
@@ -868,6 +870,14 @@ var Commet = class {
     });
   }
 };
+function createCommet(_billingConfig, options) {
+  return new Commet(options);
+}
+
+// src/types/config.ts
+function defineConfig(config) {
+  return config;
+}
 
 // src/index.ts
 var index_default = Commet;
@@ -881,6 +891,8 @@ var index_default = Commet;
   CustomerContext,
   SDK_VERSION,
   Webhooks,
+  createCommet,
+  defineConfig,
   registerIntegration
 });
 //# sourceMappingURL=index.js.map